CKTIS / Java
Base64 in Java: codificare e decodificare byte
Usa `java.util.Base64` per rappresentare i byte come testo e recuperare i byte originali. Base64 è reversibile e non garantisce né riservatezza né integrità.
Versione: Java SE 21
Sintassi
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, java.util.Base64 offre due metodi statici senza argomenti per la variante Basic: Base64.getEncoder() restituisce un Base64.Encoder e Base64.getDecoder() restituisce un Base64.Decoder. Questi oggetti si possono riutilizzare e condividere tra più thread. Il codificatore Basic non inserisce interruzioni di riga. Se il protocollo richiede la variante adatta agli URL o la variante MIME, scegli la coppia di metodi corrispondente.
Base64.Encoder.encodeToString(byte[]) riceve byte e restituisce il testo Base64 come String; encode(byte[]) restituisce invece byte codificati. Base64.Decoder.decode(String) riceve il testo Base64 e restituisce i byte originali in un nuovo array. L’overload decode(byte[]) riceve byte codificati invece del testo. Se i dati di partenza sono testo, convertili in byte con un set di caratteri esplicito come StandardCharsets.UTF_8. Dopo la decodifica Base64, usa lo stesso set di caratteri per ricostruire il testo.
Il codificatore Basic aggiunge per impostazione predefinita il riempimento finale = quando necessario. Il decodificatore accetta l’assenza del riempimento se l’ultimo gruppo contiene due o tre caratteri Base64. Il decodificatore Basic rifiuta i caratteri non appartenenti all’alfabeto consentito, inclusi gli spazi bianchi, e il riempimento non valido. In questi casi decode(String) genera IllegalArgumentException. Un argomento null causa NullPointerException.
Base64 rappresenta i byte come testo in modo reversibile: non è né una cifratura né un controllo di integrità. Chiunque può decodificare i dati e una decodifica riuscita non dimostra che siano rimasti invariati.
Esempi
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));
}
}Risultato
Y2Fmw6k= true
Il testo `café` viene convertito in byte UTF-8, codificato come `Y2Fmw6k=` e poi decodificato. `true` indica che i due array di byte hanno lo stesso contenuto.
Lezioni correlate
- Java · Lezione 51 · Avanzato · Versione: 2