Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Base64 — codificar e descodificar bytes

A classe java.util.Base64 representa bytes como texto Base64 e recupera-os através da descodificação. Aprende a variante Basic, a conversão explícita para UTF-8 e o tratamento de dados de entrada malformados.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);

Base64 de java.util disponibiliza codificadores e descodificadores. Base64 é uma representação textual reversível de bytes, não uma encriptação: não protege a confidencialidade. Esta entrada destina-se a Java SE 21; o ambiente de execução de produção não foi atestado.

Base64.getEncoder() devolve um codificador Basic. Base64.Encoder.encodeToString(byte[]) converte bytes numa String. Base64.getDecoder() devolve um descodificador Basic, e Base64.Decoder.decode(String) recupera um novo byte[] alocado. Para texto, utiliza explicitamente StandardCharsets.UTF_8 antes da codificação e depois da descodificação; o próprio Base64 não especifica a codificação de caracteres do texto original.

Basic não acrescenta quebras de linha e o seu descodificador rejeita caracteres fora do alfabeto, incluindo espaços em branco. Para a variante segura para URL, utiliza getUrlEncoder() e getUrlDecoder(). MIME tem fábricas separadas, getMimeEncoder() e getMimeDecoder(); o seu descodificador ignora caracteres fora do alfabeto. Escolhe a variante adequada ao formato dos dados.

Dados de entrada malformados passados a decode(String) causam IllegalArgumentException, enquanto null causa NullPointerException. O preenchimento final = pode ser omitido quando o último grupo contém dois ou três caracteres Base64; se existir preenchimento, a sua quantidade tem de estar correta. O exemplo verifica a recuperação do texto e apresenta o resultado esperado.

Exemplos

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);
    }
}

Resultado

SGVsbG8=
Hello

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes