CKTIS / Java
Base64 w Javie: kodowanie i dekodowanie bajtów
Użyj `java.util.Base64`, aby odwracalnie zamieniać bajty na tekst i odzyskiwać je z tego tekstu. Base64 nie zapewnia poufności ani integralności.
Wersja: Java SE 21
Składnia
import java.util.Base64;
Base64.Encoder encoder = Base64.getEncoder();
Base64.Decoder decoder = Base64.getDecoder();
String encoded = encoder.encodeToString(bytes); // bytes: byte[]
byte[] decoded = decoder.decode(encoded);W Java SE 21 klasa java.util.Base64 udostępnia dwie statyczne metody bez argumentów dla wariantu Basic: Base64.getEncoder() zwraca Base64.Encoder, a Base64.getDecoder() zwraca Base64.Decoder. Można ich używać wielokrotnie i współdzielić między wątkami. Enkoder Basic nie wstawia znaków końca wiersza. Jeśli protokół wymaga wariantu URL-safe lub MIME, wybierz odpowiednią parę metod zamiast Basic.
Base64.Encoder.encodeToString(byte[]) przyjmuje bajty i zwraca tekst Base64 jako String; encode(byte[]) zwraca zakodowane bajty. Base64.Decoder.decode(String) przyjmuje tekst Base64 i zwraca oryginalne bajty w nowej tablicy. Przeciążenie decode(byte[]) zamiast tekstu przyjmuje zakodowane bajty. Jeśli dane źródłowe są tekstem, przekształć je w bajty za pomocą jawnie wybranego kodowania znaków, np. StandardCharsets.UTF_8. Po dekodowaniu Base64 użyj tego samego kodowania znaków, aby odtworzyć tekst.
Enkoder Basic domyślnie dodaje końcowe wypełnienie =, gdy jest potrzebne. Dekoder akceptuje jego brak, jeśli ostatnia grupa zawiera dwa lub trzy znaki Base64. Dekoder Basic odrzuca znaki spoza dozwolonego alfabetu, w tym białe znaki, oraz nieprawidłowe wypełnienie; decode(String) zgłasza wtedy IllegalArgumentException. Argument null powoduje NullPointerException.
Base64 to odwracalna reprezentacja bajtów w postaci tekstu, a nie szyfrowanie ani mechanizm ochrony integralności. Każdy może odczytać zakodowane dane, a pomyślne dekodowanie nie dowodzi, że nikt ich nie zmienił.
Przykłady
import java.nio.charset.StandardCharsets;
import java.util.Arrays;
import java.util.Base64;
public class Base64RoundTrip {
public static void main(String[] args) {
byte[] original = "caf\u00E9".getBytes(StandardCharsets.UTF_8);
Base64.Encoder encoder = Base64.getEncoder();
Base64.Decoder decoder = Base64.getDecoder();
String encoded = encoder.encodeToString(original);
byte[] decoded = decoder.decode(encoded);
System.out.println(encoded);
System.out.println(Arrays.equals(original, decoded));
}
}Wynik
Y2Fmw6k= true
Tekst `café` zostaje przekształcony w bajty UTF-8, zakodowany jako `Y2Fmw6k=` i zdekodowany. `true` oznacza, że zawartość obu tablic bajtów jest taka sama.
Powiązane lekcje
- Java · Lekcja 51 · Zaawansowany · Wersja: 2