Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CodingErrorAction: zgłaszanie i zastępowanie błędnych danych

CodingErrorAction określa reakcję dekodera lub kodera znaków na błędne dane. REPORT ujawnia błąd wywołującemu, a REPLACE zastępuje wadliwy fragment skonfigurowaną wartością i kontynuuje przetwarzanie. Osobno ustawia się obsługę niepoprawnego wejścia i znaków bez odwzorowania.

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

Składnia

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

CodingErrorAction z java.nio.charset określa politykę obsługi błędów w CharsetDecoder i CharsetEncoder. Jest klasą ze stałymi reprezentującymi dostępne działania, a nie deklaracją enum. Niepoprawne wejście narusza reguły kodowania; błąd odwzorowania oznacza poprawną sekwencję, której nie można przedstawić na wyjściu. Polityki ustawia się niezależnie przez onMalformedInput(...) i onUnmappableCharacter(...).

CodingErrorAction.REPORT zgłasza błąd: metody przetwarzające bufory etapami zwracają odpowiedni CoderResult, natomiast jednoargumentowe decode(...) i encode(...) rzucają odpowiednią podklasę CharacterCodingException. Nowe dekodery i kodery domyślnie stosują REPORT dla obu rodzajów błędów. Nie oznacza to, że każde API konwersji tekstu ma taką samą politykę.

CodingErrorAction.REPLACE pomija wadliwy fragment, dopisuje wartość zastępczą i kontynuuje. Dekoder wstawia tekst, a koder — bajty; wartość można zmienić przez replaceWith(...). To utrata informacji, nie naprawa oryginału. Wybierz REPORT, gdy błędy mają być wykrywane, a REPLACE tylko wtedy, gdy akceptujesz zastępowanie. Przykład dla Java SE 21 porównuje oba działania na niepoprawnym bajcie UTF-8 i jawnie ustawia ?, aby wynik był czytelny.

Przykłady

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

Wynik

REPORT: MalformedInputException
REPLACE: ?A

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła