Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Base64 en Java: codificar y decodificar bytes

Usa `java.util.Base64` para representar bytes como texto y recuperar los bytes originales. Base64 es reversible y no aporta confidencialidad ni integridad.

Versión: Java SE 21

Sintaxis

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

En Java SE 21, java.util.Base64 ofrece dos métodos estáticos sin argumentos para la variante Basic: Base64.getEncoder() devuelve un Base64.Encoder y Base64.getDecoder() devuelve un Base64.Decoder. Estos objetos se pueden reutilizar y compartir entre hilos. El codificador Basic no inserta saltos de línea. Si el protocolo exige la variante apta para URL o la variante MIME, elige el par de métodos correspondiente.

Base64.Encoder.encodeToString(byte[]) recibe bytes y devuelve texto Base64 como String; encode(byte[]) devuelve bytes codificados. Base64.Decoder.decode(String) recibe texto Base64 y devuelve los bytes originales en un nuevo array. La sobrecarga decode(byte[]) recibe bytes codificados en vez de texto. Si los datos originales son texto, conviértelos en bytes con un juego de caracteres explícito, como StandardCharsets.UTF_8. Tras decodificar Base64, usa el mismo juego de caracteres para reconstruir el texto.

El codificador Basic añade por defecto relleno = al final cuando hace falta. El descodificador acepta que no haya relleno si el grupo final contiene dos o tres caracteres Base64. El descodificador Basic rechaza los caracteres ajenos al alfabeto permitido, incluidos los espacios en blanco, y el relleno incorrecto. En estos casos, decode(String) lanza IllegalArgumentException. Un argumento null provoca NullPointerException.

Base64 es una representación reversible de bytes como texto, no un cifrado ni una comprobación de integridad. Cualquiera puede decodificar los datos, y que la decodificación tenga éxito no demuestra que los datos sigan intactos.

Ejemplos

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

El texto `café` se convierte en bytes UTF-8, se codifica como `Y2Fmw6k=` y se decodifica. `true` indica que ambos arrays de bytes tienen el mismo contenido.

Lecciones relacionadas

  • Java · Lección 51 · Avanzado · Versión: 2

Fuentes