CKTIS / Java
CodingErrorAction: hlášení nebo nahrazování neplatného vstupu
CodingErrorAction určuje, jak dekodér nebo kodér znakové sady zpracuje chyby kódování. REPORT zpřístupní chybu volajícímu, zatímco REPLACE nahradí chybnou část nakonfigurovanou hodnotou a pokračuje ve zpracování. Zásady pro chybný vstup a nepřevoditelné znaky se nastavují samostatně.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
coder.onMalformedInput(CodingErrorAction.REPORT);
coder.onUnmappableCharacter(CodingErrorAction.REPLACE);CodingErrorAction z java.nio.charset definuje zásady zpracování chyb pro CharsetDecoder a CharsetEncoder. Jde o třídu s konstantami představujícími dostupné akce, nikoli o deklaraci enum. Chybný vstup porušuje pravidla kódování; chyba nepřevoditelného znaku znamená, že platnou sekvenci nelze vyjádřit ve výstupu. Tyto zásady nastavte nezávisle pomocí onMalformedInput(...) a onUnmappableCharacter(...).
CodingErrorAction.REPORT ohlásí chybu: metody pro přírůstkové zpracování bufferů vracejí odpovídající CoderResult, zatímco metody decode(...) a encode(...) s jedním argumentem vyhazují odpovídající podtřídu CharacterCodingException. Nové dekodéry a kodéry používají ve výchozím nastavení REPORT pro obě kategorie chyb. To neznamená, že každé API pro převod textu používá stejné zásady.
CodingErrorAction.REPLACE přeskočí chybný vstup, přidá náhradní hodnotu a pokračuje. Dekodér vloží text, kodér bajty. Tuto hodnotu změňte pomocí replaceWith(...). Dochází tak ke ztrátě informací; původní data se neopravují. Zvolte REPORT, pokud je třeba chyby zjistit, a REPLACE pouze tehdy, pokud je nahrazování přijatelné. Příklad pro Java SE 21 porovnává obě akce na neplatném bajtu UTF-8 a výslovně nastavuje ?, aby byl výstup čitelný.
Příklady
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)));
}
}Výsledek
REPORT: MalformedInputException REPLACE: ?A
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.