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