WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

CodingErrorAction: ungültige Eingaben melden oder ersetzen

CodingErrorAction legt fest, wie ein Zeichensatz-Decoder oder -Encoder mit Codierungsfehlern umgeht. REPORT macht einen Fehler für den Aufrufer sichtbar; REPLACE ersetzt den fehlerhaften Teil durch den konfigurierten Wert und setzt die Verarbeitung fort. Für fehlerhafte Eingaben und nicht abbildbare Zeichen werden die Richtlinien getrennt festgelegt.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

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

CodingErrorAction aus java.nio.charset legt Fehlerbehandlungsrichtlinien für CharsetDecoder und CharsetEncoder fest. Es handelt sich um eine Klasse mit Konstanten für die verfügbaren Aktionen, nicht um eine enum-Deklaration. Fehlerhafte Eingaben verstoßen gegen die Codierungsregeln; ein nicht abbildbarer Fehler liegt vor, wenn eine gültige Sequenz nicht in der Ausgabe dargestellt werden kann. Die Richtlinien werden unabhängig voneinander mit onMalformedInput(...) und onUnmappableCharacter(...) festgelegt.

CodingErrorAction.REPORT meldet einen Fehler: Methoden zur schrittweisen Pufferverarbeitung geben ein entsprechendes CoderResult zurück, während die einargumentigen Methoden decode(...) und encode(...) eine passende Unterklasse von CharacterCodingException auslösen. Neue Decoder und Encoder verwenden standardmäßig REPORT für beide Fehlerkategorien. Das bedeutet nicht, dass jede API zur Textkonvertierung dieselbe Richtlinie verwendet.

CodingErrorAction.REPLACE überspringt die fehlerhafte Eingabe, fügt den Ersatzwert ein und fährt fort. Ein Decoder fügt Text ein, ein Encoder Bytes. Der Wert lässt sich mit replaceWith(...) ändern. Dabei gehen Informationen verloren; das Original wird nicht repariert. Wähle REPORT, wenn Fehler erkannt werden müssen, und REPLACE nur, wenn Ersetzungen akzeptabel sind. Das Beispiel für Java SE 21 vergleicht beide Aktionen anhand eines ungültigen UTF-8-Bytes und legt ? ausdrücklich fest, damit die Ausgabe gut lesbar ist.

Beispiele

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)));
    }
}

Ergebnis

REPORT: MalformedInputException
REPLACE: ?A

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen