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.