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.