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

CKTIS / Java

CharsetDecoder — decodificar bytes con control de errores

CharsetDecoder convierte bytes de un juego de caracteres seleccionado en caracteres Unicode. Permite configurar por separado el tratamiento de secuencias mal formadas y no representables: informar de errores, sustituir la entrada o ignorarla.

Versión: Documentation target: Java SE 21; repository and production runtime versions are not attested.

Sintaxis

CharsetDecoder decoder = charset.newDecoder()
    .onMalformedInput(CodingErrorAction.REPORT)
    .onUnmappableCharacter(CodingErrorAction.REPORT);
CharBuffer text = decoder.decode(input);

java.nio.charset.CharsetDecoder convierte bytes en caracteres Unicode; créelo mediante charset.newDecoder(). Esta entrada se refiere a Java SE 21; las versiones de los entornos de ejecución del repositorio y de producción no están acreditadas.

CharsetDecoder.onMalformedInput controla las secuencias no válidas en el juego de caracteres. CharsetDecoder.onUnmappableCharacter se ocupa de las secuencias válidas que no tienen correspondencia con caracteres Unicode. Ambos métodos aceptan CodingErrorAction: REPORT informa de un error, REPLACE sustituye los datos erróneos e IGNORE los descarta. Sustituir y omitir provoca pérdida de información.

CharsetDecoder.decode(ByteBuffer) devuelve un CharBuffer; con REPORT, los errores se lanzan como excepciones de la familia CharacterCodingException. La sobrecarga decode(ByteBuffer, CharBuffer, boolean) permite el procesamiento incremental y devuelve un CoderResult que debe tratarse.

El ejemplo usa 0xFF, un byte UTF-8 no válido. Primero informa del error y después sustituye el byte por ?. Esto demuestra una entrada mal formada, no una secuencia no representable; la segunda política sigue configurada como REPORT.

Ejemplos

import java.nio.ByteBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.CharsetDecoder;
import java.nio.charset.CodingErrorAction;
import java.nio.charset.StandardCharsets;

public class DecoderDemo {
    public static void main(String[] args) throws CharacterCodingException {
        byte[] bytes = {65, (byte) 0xFF, 66};
        CharsetDecoder decoder = StandardCharsets.UTF_8.newDecoder()
            .onMalformedInput(CodingErrorAction.REPORT)
            .onUnmappableCharacter(CodingErrorAction.REPORT);

        try {
            decoder.decode(ByteBuffer.wrap(bytes));
        } catch (CharacterCodingException ex) {
            System.out.println("REPORT: " + ex.getClass().getSimpleName());
        }

        decoder.reset();
        decoder.onMalformedInput(CodingErrorAction.REPLACE)
            .replaceWith("?");
        System.out.println("REPLACE: " + decoder.decode(ByteBuffer.wrap(bytes)));
    }
}

Resultado

REPORT: MalformedInputException
REPLACE: A?B

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.

Fuentes