CKTIS / Java
Base64 in Java: Bytes kodieren und dekodieren
Mit `java.util.Base64` lassen sich Bytes als Text darstellen und daraus wiederherstellen. Base64 ist umkehrbar und bietet weder Vertraulichkeit noch Integrität.
Version: Java SE 21
Syntax
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);In Java SE 21 bietet java.util.Base64 zwei statische Methoden ohne Argumente für die Variante Basic: Base64.getEncoder() liefert einen Base64.Encoder, Base64.getDecoder() einen Base64.Decoder. Beide Objekte lassen sich wiederverwenden und von mehreren Threads gemeinsam nutzen. Der Basic-Encoder fügt keine Zeilenumbrüche ein. Verlangt ein Protokoll die URL-sichere Variante oder MIME, verwende stattdessen das passende Methodenpaar.
Base64.Encoder.encodeToString(byte[]) nimmt Bytes entgegen und liefert Base64-Text als String; encode(byte[]) liefert stattdessen kodierte Bytes. Base64.Decoder.decode(String) nimmt Base64-Text entgegen und gibt die ursprünglichen Bytes in einem neuen Array zurück. Die Überladung decode(byte[]) erwartet statt Text bereits kodierte Bytes. Liegen die Ausgangsdaten als Text vor, wandle ihn mit einem expliziten Zeichensatz wie StandardCharsets.UTF_8 in Bytes um. Verwende nach der Base64-Dekodierung denselben Zeichensatz, um den Text wiederherzustellen.
Der Basic-Encoder hängt bei Bedarf standardmäßig = als Füllzeichen an. Der Decoder akzeptiert fehlende Füllzeichen, wenn die letzte Gruppe zwei oder drei Base64-Zeichen enthält. Der Basic-Decoder weist Zeichen außerhalb des zulässigen Alphabets, darunter Leerraumzeichen, und fehlerhafte Füllzeichen zurück. In diesen Fällen löst decode(String) eine IllegalArgumentException aus. Ein null-Argument verursacht eine NullPointerException.
Base64 stellt Bytes umkehrbar als Text dar. Es verschlüsselt die Daten nicht und prüft auch nicht deren Integrität. Jeder kann die Daten dekodieren; eine erfolgreiche Dekodierung beweist nicht, dass sie unverändert sind.
Beispiele
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));
}
}Ergebnis
Y2Fmw6k= true
Der Text `café` wird in UTF-8-Bytes umgewandelt, als `Y2Fmw6k=` kodiert und wieder dekodiert. `true` bedeutet, dass beide Byte-Arrays denselben Inhalt haben.
Zugehörige Lektionen
- Java · Lektion 51 · Fortgeschritten · Version: 2