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

CKTIS / Java

CodingErrorAction: informar de entradas no válidas o reemplazarlas

CodingErrorAction controla cómo gestiona los errores de codificación un decodificador o codificador de caracteres. REPORT comunica el error al código que realiza la llamada, mientras que REPLACE sustituye el fragmento defectuoso por el valor configurado y continúa el procesamiento. Las políticas para entradas mal formadas y caracteres no representables se configuran por separado.

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

Sintaxis

coder.onMalformedInput(CodingErrorAction.REPORT);
coder.onUnmappableCharacter(CodingErrorAction.REPLACE);

CodingErrorAction, de java.nio.charset, define políticas de gestión de errores para CharsetDecoder y CharsetEncoder. Es una clase con constantes que representan las acciones disponibles, no una declaración enum. Una entrada mal formada incumple las reglas de codificación; un error de carácter no representable significa que una secuencia válida no puede representarse en la salida. Configura estas políticas por separado mediante onMalformedInput(...) y onUnmappableCharacter(...).

CodingErrorAction.REPORT informa de un error: los métodos de procesamiento incremental de búferes devuelven un CoderResult adecuado, mientras que los métodos de un solo argumento decode(...) y encode(...) lanzan una subclase adecuada de CharacterCodingException. Los decodificadores y codificadores nuevos usan REPORT de forma predeterminada para ambas categorías de error. Esto no significa que todas las API de conversión de texto utilicen la misma política.

CodingErrorAction.REPLACE omite la entrada errónea, añade el valor de reemplazo y continúa. Un decodificador inserta texto; un codificador, bytes. Cambia ese valor con replaceWith(...). Esto provoca pérdida de información, no repara el original. Elige REPORT cuando sea necesario detectar errores y REPLACE solo cuando la sustitución sea aceptable. El ejemplo para Java SE 21 compara ambas acciones con un byte UTF-8 no válido y establece explícitamente ? para que el resultado sea legible.

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) throws CharacterCodingException {
        byte[] input = {(byte) 0xFF, 0x41};

        var strict = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPORT);
        try {
            strict.decode(ByteBuffer.wrap(input));
        } catch (CharacterCodingException e) {
            System.out.println("REPORT: " + e.getClass().getSimpleName());
        }

        var tolerant = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPLACE)
                .replaceWith("?");
        System.out.println("REPLACE: " + tolerant.decode(ByteBuffer.wrap(input)));
    }
}

Resultado

REPORT: MalformedInputException
REPLACE: ?A

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