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.