CKTIS / Java
Base64 – Bytes kodieren und dekodieren
Die Klasse java.util.Base64 stellt Bytes als Base64-Text dar und gewinnt sie durch Dekodieren zurück. Lerne die Basic-Variante, die explizite UTF-8-Konvertierung und den Umgang mit fehlerhaften Eingaben kennen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);Base64 aus java.util stellt Encoder und Decoder bereit. Base64 ist eine umkehrbare Textdarstellung von Bytes, keine Verschlüsselung: Sie schützt nicht die Vertraulichkeit. Dieser Eintrag bezieht sich auf Java SE 21; die Produktionslaufzeit wurde nicht bestätigt.
Base64.getEncoder() gibt einen Basic-Encoder zurück. Base64.Encoder.encodeToString(byte[]) wandelt Bytes in einen String um. Base64.getDecoder() gibt einen Basic-Decoder zurück, und Base64.Decoder.decode(String) stellt ein neu angelegtes byte[] wieder her. Verwende für Text vor dem Kodieren und nach dem Dekodieren ausdrücklich StandardCharsets.UTF_8; Base64 selbst legt die Zeichenkodierung des ursprünglichen Textes nicht fest.
Basic fügt keine Zeilenumbrüche ein, und sein Decoder weist Zeichen außerhalb des Alphabets zurück, einschließlich Leerzeichen. Für die URL-sichere Variante verwende getUrlEncoder() und getUrlDecoder(). MIME hat eigene Factory-Methoden, getMimeEncoder() und getMimeDecoder(); sein Decoder ignoriert Zeichen außerhalb des Alphabets. Wähle die Variante passend zum Datenformat.
Fehlerhafte Eingaben für decode(String) führen zu IllegalArgumentException, während null zu NullPointerException führt. Nachgestellte =-Füllzeichen dürfen weggelassen werden, wenn die letzte Gruppe zwei oder drei Base64-Zeichen enthält; sind Füllzeichen vorhanden, muss ihre Anzahl korrekt sein. Das Beispiel prüft, ob der Text wiederhergestellt wird, und zeigt die erwartete Ausgabe.
Beispiele
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);
}
}Ergebnis
SGVsbG8= Hello
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.