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.