CKTIS / Java
CodingErrorAction: hlásenie alebo nahrádzanie neplatného vstupu
CodingErrorAction určuje, ako dekodér alebo kodér znakovej sady spracuje chyby kódovania. REPORT sprístupní chybu volajúcemu, zatiaľ čo REPLACE nahradí chybnú časť nakonfigurovanou hodnotou a pokračuje v spracovaní. Zásady pre chybný vstup a nemapovateľné znaky sa nastavujú samostatne.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
coder.onMalformedInput(CodingErrorAction.REPORT);
coder.onUnmappableCharacter(CodingErrorAction.REPLACE);CodingErrorAction z java.nio.charset definuje zásady spracovania chýb pre CharsetDecoder a CharsetEncoder. Je to trieda s konštantami, ktoré predstavujú dostupné akcie, nie deklarácia enum. Chybný vstup porušuje pravidlá kódovania; chyba nemapovateľného znaku znamená, že platnú sekvenciu nemožno vyjadriť vo výstupe. Tieto zásady nastavte nezávisle pomocou onMalformedInput(...) a onUnmappableCharacter(...).
CodingErrorAction.REPORT ohlási chybu: metódy na inkrementálne spracovanie bufferov vracajú zodpovedajúci CoderResult, zatiaľ čo metódy decode(...) a encode(...) s jedným argumentom vyhadzujú zodpovedajúcu podtriedu CharacterCodingException. Nové dekodéry a kodéry používajú predvolene REPORT pre obe kategórie chýb. To neznamená, že každé API na konverziu textu používa rovnaké zásady.
CodingErrorAction.REPLACE preskočí chybný vstup, pridá náhradnú hodnotu a pokračuje. Dekodér vloží text, kodér bajty. Túto hodnotu zmeňte pomocou replaceWith(...). Dochádza tak k strate informácií; pôvodné údaje sa neopravujú. Zvoľte REPORT, ak treba chyby zistiť, a REPLACE iba vtedy, ak je nahrádzanie prijateľné. Príklad pre Java SE 21 porovnáva obe akcie na neplatnom bajte UTF-8 a výslovne nastavuje ?, aby bol výstup čitateľný.
Prí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ýsledok
REPORT: MalformedInputException REPLACE: ?A
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.