CKTIS / Java
Base64 — bytes coderen en decoderen
De klasse java.util.Base64 geeft bytes weer als Base64-tekst en haalt ze terug door ze te decoderen. Leer de Basic-variant, expliciete UTF-8-conversie en het omgaan met ongeldige invoer kennen.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);Base64 in java.util biedt encoders en decoders. Base64 is een omkeerbare tekstuele weergave van bytes, geen versleuteling: het beschermt de vertrouwelijkheid niet. Dit artikel richt zich op Java SE 21; de productie-runtime is niet bevestigd.
Base64.getEncoder() geeft een Basic-encoder terug. Base64.Encoder.encodeToString(byte[]) zet bytes om in een String. Base64.getDecoder() geeft een Basic-decoder terug, en Base64.Decoder.decode(String) herstelt een nieuw toegewezen byte[]. Gebruik voor tekst expliciet StandardCharsets.UTF_8 vóór het coderen en na het decoderen; Base64 zelf bepaalt de tekencodering van de oorspronkelijke tekst niet.
Basic voegt geen regeleinden toe en de decoder ervan weigert tekens buiten het alfabet, waaronder witruimte. Gebruik getUrlEncoder() en getUrlDecoder() voor de URL-veilige variant. MIME heeft aparte fabrieksmethoden, getMimeEncoder() en getMimeDecoder(); de decoder daarvan negeert tekens buiten het alfabet. Kies de variant die bij het gegevensformaat past.
Ongeldige invoer voor decode(String) veroorzaakt IllegalArgumentException, terwijl null NullPointerException veroorzaakt. Opvulling met afsluitende = mag worden weggelaten als de laatste groep twee of drie Base64-tekens bevat; als er opvulling is, moet het aantal kloppen. Het voorbeeld controleert of de tekst wordt hersteld en toont de verwachte uitvoer.
Voorbeelden
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);
}
}Resultaat
SGVsbG8= Hello
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.