Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti