CKTIS / Java
CharacterCodingException — chyby kódovania a dekódovania
CharacterCodingException je kontrolovaná výnimka z java.nio.charset, ktorá rozširuje IOException. Signalizuje zlyhanie pri prevode medzi znakmi a bajtmi a poskytuje spoločný typ na zachytenie chybného vstupu aj nemapovateľných znakov.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
public class CharacterCodingException extends IOException
public CharacterCodingException()CharacterCodingException z balíka java.nio.charset je kontrolovaná výnimka rozširujúca IOException. Týka sa kódovania znakov na bajty a dekódovania bajtov na znaky. Ak volaná metóda deklaruje túto výnimku, treba ju zachytiť alebo deklarovať vhodný typ v throws. Trieda poskytuje verejný bezparametrický konštruktor CharacterCodingException().
Jej priamymi podtriedami sú MalformedInputException a UnmappableCharacterException. Prvá označuje neplatnú vstupnú sekvenciu, napríklad chybné bajty UTF-8; druhá platnú sekvenciu, ktorú nemožno previesť na cieľovú reprezentáciu. catch (CharacterCodingException e) zachytí oba druhy zlyhania. Nezamieňajte si ich s UnsupportedCharsetException, ktorá znamená, že požadovaná znaková sada nie je podporovaná.
Nový CharsetDecoder štandardne hlási oba typy chýb; príklad výslovne nastavuje CodingErrorAction.REPORT. Volanie decode(ByteBuffer) s jedným argumentom potom vyvolá príslušnú podtriedu výnimky. Prúdová verzia decode(ByteBuffer, CharBuffer, boolean) naopak vracia CoderResult, ktorý treba skontrolovať. Nastavenia REPLACE a IGNORE chybné údaje nahrádzajú, respektíve vynechávajú, takže menia spracovanie chýb a môžu spôsobiť stratu informácií.
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) {
var decoder = StandardCharsets.UTF_8.newDecoder()
.onMalformedInput(CodingErrorAction.REPORT)
.onUnmappableCharacter(CodingErrorAction.REPORT);
byte[] bytes = {(byte) 0xC3, (byte) 0x28};
try {
decoder.decode(ByteBuffer.wrap(bytes));
System.out.println("Decoded successfully");
} catch (CharacterCodingException e) {
System.out.println(e.getClass().getSimpleName());
}
}
}Výsledok
MalformedInputException
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.