CKTIS / Java
CodingErrorAction: prijava ili zamjena nevažećeg ulaza
CodingErrorAction određuje kako dekoder ili koder skupa znakova obrađuje pogreške kodiranja. REPORT prijavljuje pogrešku pozivatelju, dok REPLACE zamjenjuje neispravan dio konfiguriranom vrijednošću i nastavlja obradu. Pravila za neispravan ulaz i znakove koji se ne mogu preslikati postavljaju se zasebno.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
coder.onMalformedInput(CodingErrorAction.REPORT);
coder.onUnmappableCharacter(CodingErrorAction.REPLACE);CodingErrorAction iz java.nio.charset definira pravila obrade pogrešaka za CharsetDecoder i CharsetEncoder. To je klasa s konstantama koje predstavljaju dostupne radnje, a ne deklaracija enum. Neispravan ulaz krši pravila kodiranja; pogreška znaka koji se ne može preslikati znači da se valjan niz ne može prikazati u izlazu. Ta se pravila postavljaju neovisno pomoću onMalformedInput(...) i onUnmappableCharacter(...).
CodingErrorAction.REPORT prijavljuje pogrešku: metode za postupnu obradu međuspremnika vraćaju odgovarajući CoderResult, dok metode decode(...) i encode(...) s jednim argumentom izbacuju odgovarajuću podklasu CharacterCodingException. Novi dekoderi i koderi prema zadanim postavkama koriste REPORT za obje kategorije pogrešaka. To ne znači da svaki API za pretvorbu teksta primjenjuje isto pravilo.
CodingErrorAction.REPLACE preskače neispravan ulaz, dodaje zamjensku vrijednost i nastavlja. Dekoder umeće tekst, a koder bajtove. Vrijednost promijenite pomoću replaceWith(...). Time se gube informacije; izvorni se sadržaj ne popravlja. Odaberite REPORT kada pogreške treba otkriti, a REPLACE samo ako je zamjena prihvatljiva. Primjer za Java SE 21 uspoređuje obje radnje na nevažećem UTF-8 bajtu i izričito postavlja ? kako bi izlaz bio čitljiv.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.