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

CKTIS / Java

Base64 em Java: codificar e descodificar bytes

Utiliza `java.util.Base64` para representar bytes como texto e recuperar os bytes originais. Base64 é reversível e não garante confidencialidade nem integridade.

Versão: Java SE 21

Sintaxe

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

Em Java SE 21, java.util.Base64 disponibiliza dois métodos estáticos sem argumentos para a variante Basic: Base64.getEncoder() devolve um Base64.Encoder e Base64.getDecoder() devolve um Base64.Decoder. Estes objetos podem ser reutilizados e partilhados entre threads. O codificador Basic não insere quebras de linha. Se um protocolo exigir a variante adequada para URL ou a variante MIME, escolhe o par de métodos correspondente.

Base64.Encoder.encodeToString(byte[]) recebe bytes e devolve texto Base64 como String; encode(byte[]) devolve bytes codificados. Base64.Decoder.decode(String) recebe texto Base64 e devolve os bytes originais num novo array. A sobrecarga decode(byte[]) recebe bytes codificados em vez de texto. Se os dados originais forem texto, converte-os em bytes com um conjunto de caracteres explícito, como StandardCharsets.UTF_8. Após descodificar Base64, usa o mesmo conjunto de caracteres para reconstruir o texto.

Por omissão, o codificador Basic adiciona preenchimento = no fim quando necessário. O descodificador aceita a ausência de preenchimento se o último grupo contiver dois ou três caracteres Base64. O descodificador Basic rejeita caracteres fora do alfabeto permitido, incluindo caracteres de espaço em branco, e preenchimento inválido. Nestes casos, decode(String) lança IllegalArgumentException. Um argumento null provoca NullPointerException.

Base64 é uma forma reversível de representar bytes como texto, não um método de cifragem nem uma verificação de integridade. Qualquer pessoa pode descodificar os dados, e uma descodificação bem-sucedida não demonstra que tenham permanecido inalterados.

Exemplos

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

Resultado

Y2Fmw6k=
true

O texto `café` é convertido em bytes UTF-8, codificado como `Y2Fmw6k=` e descodificado. `true` indica que os dois arrays de bytes têm o mesmo conteúdo.

Lições relacionadas

  • Java · Lição 51 · Avançado · Versão: 2

Fontes