CKTIS / Java
Base64 — kodowanie i dekodowanie bajtów
Klasa java.util.Base64 pozwala zapisać bajty jako tekst Base64 i odzyskać je przez dekodowanie. Poznaj wariant Basic, jawne użycie UTF-8 oraz obsługę niepoprawnych danych.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);Base64 z pakietu java.util udostępnia kodery i dekodery. Base64 jest odwracalnym zapisem bajtów jako tekstu, a nie szyfrowaniem: nie chroni poufności danych. Opis dotyczy Java SE 21; środowisko produkcyjne nie zostało potwierdzone.
Base64.getEncoder() zwraca koder Basic. Metoda Base64.Encoder.encodeToString(byte[]) przekształca bajty w String. Base64.getDecoder() zwraca dekoder Basic, a Base64.Decoder.decode(String) odtwarza nową tablicę byte[]. Dla tekstu jawnie zastosuj StandardCharsets.UTF_8 przed kodowaniem i po dekodowaniu; samo Base64 nie określa kodowania znaków oryginału.
Basic nie dodaje podziałów wierszy, a jego dekoder odrzuca znaki spoza alfabetu, w tym białe znaki. Do wariantu URL-safe służą getUrlEncoder() i getUrlDecoder(). Wariant MIME ma osobne fabryki getMimeEncoder() i getMimeDecoder(); jego dekoder ignoruje znaki spoza alfabetu. Dobierz wariant do formatu danych.
Niepoprawne dane przekazane do decode(String) powodują IllegalArgumentException, a null powoduje NullPointerException. Końcowe dopełnienie = można pominąć, gdy ostatnia grupa zawiera dwa lub trzy znaki Base64; jeśli dopełnienie występuje, jego liczba musi być poprawna. Przykład sprawdza odzyskanie tekstu i pokazuje oczekiwany wynik.
Przykłady
import java.nio.charset.StandardCharsets;
import java.util.Base64;
public class Main {
public static void main(String[] args) {
String original = "Hello";
byte[] bytes = original.getBytes(StandardCharsets.UTF_8);
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);
String restored = new String(decoded, StandardCharsets.UTF_8);
if (!original.equals(restored)) {
throw new AssertionError("Round-trip failed");
}
System.out.println(encoded);
System.out.println(restored);
}
}Wynik
SGVsbG8= Hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.