WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen