CKTIS / Java
Base64: codificar y decodificar bytes
La clase java.util.Base64 representa bytes como texto Base64 y los recupera al decodificarlos. Aprende la variante Basic, la conversión explícita a UTF-8 y cómo tratar entradas mal formadas.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);Base64 de java.util proporciona codificadores y decodificadores. Base64 es una representación textual reversible de bytes, no un cifrado: no protege la confidencialidad. Esta ficha está dirigida a Java SE 21; el entorno de ejecución de producción no ha sido certificado.
Base64.getEncoder() devuelve un codificador Basic. Base64.Encoder.encodeToString(byte[]) convierte bytes en un String. Base64.getDecoder() devuelve un decodificador Basic, y Base64.Decoder.decode(String) recupera un nuevo byte[] asignado. Para texto, utiliza explícitamente StandardCharsets.UTF_8 antes de codificar y después de decodificar; Base64 por sí mismo no especifica la codificación de caracteres del texto original.
Basic no añade saltos de línea y su decodificador rechaza los caracteres que no pertenecen a su alfabeto, incluidos los espacios en blanco. Para la variante segura para URL, utiliza getUrlEncoder() y getUrlDecoder(). MIME tiene fábricas separadas, getMimeEncoder() y getMimeDecoder(); su decodificador ignora los caracteres ajenos al alfabeto. Elige la variante adecuada al formato de los datos.
Una entrada mal formada para decode(String) provoca IllegalArgumentException, mientras que null provoca NullPointerException. Se puede omitir el relleno final = cuando el último grupo contiene dos o tres caracteres Base64; si hay relleno, su cantidad debe ser correcta. El ejemplo comprueba que se recupere el texto y muestra la salida esperada.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.