CKTIS / Java
Base64 — codificare e decodificare byte
La classe java.util.Base64 rappresenta i byte come testo Base64 e li recupera decodificandoli. Scopri la variante Basic, la conversione esplicita in UTF-8 e la gestione di input non validi.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);Base64 di java.util fornisce codificatori e decodificatori. Base64 è una rappresentazione testuale reversibile dei byte, non una cifratura: non protegge la riservatezza. Questa scheda riguarda Java SE 21; l’ambiente di esecuzione in produzione non è stato attestato.
Base64.getEncoder() restituisce un codificatore Basic. Base64.Encoder.encodeToString(byte[]) converte i byte in una String. Base64.getDecoder() restituisce un decodificatore Basic e Base64.Decoder.decode(String) recupera un nuovo byte[] allocato. Per il testo, usa esplicitamente StandardCharsets.UTF_8 prima della codifica e dopo la decodifica; Base64 da solo non specifica la codifica dei caratteri del testo originale.
Basic non aggiunge interruzioni di riga e il suo decodificatore rifiuta i caratteri che non appartengono all’alfabeto, inclusi gli spazi vuoti. Per la variante sicura per gli URL, usa getUrlEncoder() e getUrlDecoder(). MIME dispone di factory separate, getMimeEncoder() e getMimeDecoder(); il suo decodificatore ignora i caratteri estranei all’alfabeto. Scegli la variante in base al formato dei dati.
Un input non valido passato a decode(String) causa IllegalArgumentException, mentre null causa NullPointerException. Il padding finale = può essere omesso quando il gruppo finale contiene due o tre caratteri Base64; se è presente, il numero di caratteri di padding deve essere corretto. L’esempio verifica il recupero del testo e mostra l’output atteso.
Esempi
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);
}
}Risultato
SGVsbG8= Hello
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.