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

CKTIS / Java

CharacterCodingException — errores de codificación y decodificación

CharacterCodingException es una excepción comprobada de java.nio.charset que extiende IOException. Indica un fallo al convertir entre caracteres y bytes y ofrece un tipo común para capturar entradas mal formadas y caracteres que no se pueden representar.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

public class CharacterCodingException extends IOException
public CharacterCodingException()

CharacterCodingException, de java.nio.charset, es una excepción comprobada que extiende IOException. Está relacionada con la codificación de caracteres en bytes y la decodificación de bytes en caracteres. Si un método llamado declara esta excepción, hay que capturarla o declarar un tipo apropiado en throws. La clase proporciona el constructor público sin argumentos CharacterCodingException().

Sus subclases directas son MalformedInputException y UnmappableCharacterException. La primera indica una secuencia de entrada no válida, como bytes UTF-8 mal formados; la segunda, una secuencia válida que no se puede asignar a la representación de destino. catch (CharacterCodingException e) captura ambos tipos de fallo. No hay que confundirlos con UnsupportedCharsetException, que indica que el conjunto de caracteres solicitado no es compatible.

Un CharsetDecoder nuevo informa de ambos tipos de error de forma predeterminada; el ejemplo establece explícitamente CodingErrorAction.REPORT. La llamada de un argumento decode(ByteBuffer) lanza entonces la subclase de excepción correspondiente. En cambio, la sobrecarga de flujo decode(ByteBuffer, CharBuffer, boolean) devuelve un CoderResult que hay que comprobar. Las opciones REPLACE e IGNORE sustituyen o descartan, respectivamente, los datos erróneos, por lo que cambian el tratamiento de errores y pueden causar pérdida de información.

Ejemplos

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

public class Main {
    public static void main(String[] args) {
        var decoder = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPORT)
                .onUnmappableCharacter(CodingErrorAction.REPORT);
        byte[] bytes = {(byte) 0xC3, (byte) 0x28};

        try {
            decoder.decode(ByteBuffer.wrap(bytes));
            System.out.println("Decoded successfully");
        } catch (CharacterCodingException e) {
            System.out.println(e.getClass().getSimpleName());
        }
    }
}

Resultado

MalformedInputException

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