CKTIS / Java
CodingErrorAction: poročanje o neveljavnih vhodnih podatkih ali njihovo nadomeščanje
CodingErrorAction določa, kako dekodirnik ali kodirnik znakovne zbirke obravnava napake pri kodiranju. REPORT napako sporoči klicatelju, REPLACE pa napačni del nadomesti z nastavljeno vrednostjo in nadaljuje obdelavo. Politiki za napačne vhodne podatke in znake, ki jih ni mogoče preslikati, se nastavita ločeno.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
coder.onMalformedInput(CodingErrorAction.REPORT);
coder.onUnmappableCharacter(CodingErrorAction.REPLACE);CodingErrorAction iz java.nio.charset določa pravilnike za obravnavo napak pri CharsetDecoder in CharsetEncoder. Gre za razred s konstantami, ki predstavljajo razpoložljiva dejanja, ne pa za deklaracijo enum. Napačni vhodni podatki kršijo pravila kodiranja; napaka zaradi znaka, ki ga ni mogoče preslikati, pomeni, da veljavnega zaporedja ni mogoče predstaviti v izhodu. Pravilnika nastavite ločeno z onMalformedInput(...) in onUnmappableCharacter(...).
CodingErrorAction.REPORT sporoči napako: metode za postopno obdelavo medpomnilnikov vrnejo ustrezen CoderResult, medtem ko metodi decode(...) in encode(...) z enim argumentom vržeta ustrezen podrazred CharacterCodingException. Novi dekodirniki in kodirniki za obe kategoriji napak privzeto uporabljajo REPORT. To ne pomeni, da vsak API za pretvorbo besedila uporablja enak pravilnik.
CodingErrorAction.REPLACE preskoči napačni vhodni podatek, doda nadomestno vrednost in nadaljuje. Dekodirnik vstavi besedilo, kodirnik pa bajte. Vrednost spremenite z replaceWith(...). Pri tem se izgubijo informacije; izvirnik se ne popravi. Izberite REPORT, kadar je treba napake zaznati, REPLACE pa le, če je nadomeščanje sprejemljivo. Primer za Java SE 21 primerja obe dejanji na neveljavnem bajtu UTF-8 in izrecno nastavi ?, da je rezultat berljiv.
Primeri
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)));
}
}Rezultat
REPORT: MalformedInputException REPLACE: ?A
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.