CKTIS / Java
CharacterCodingException — pogreške kodiranja i dekodiranja
CharacterCodingException je provjerena iznimka iz java.nio.charset koja proširuje IOException. Označava neuspjeh pri pretvorbi između znakova i bajtova te pruža zajednički tip za hvatanje neispravnog ulaza i znakova koji se ne mogu preslikati.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public class CharacterCodingException extends IOException
public CharacterCodingException()CharacterCodingException iz paketa java.nio.charset provjerena je iznimka koja proširuje IOException. Odnosi se na kodiranje znakova u bajtove i dekodiranje bajtova u znakove. Ako pozvana metoda deklarira ovu iznimku, potrebno ju je uhvatiti ili deklarirati odgovarajući tip u throws. Klasa pruža javni konstruktor bez argumenata CharacterCodingException().
Njezine izravne podklase su MalformedInputException i UnmappableCharacterException. Prva označava nevaljan ulazni niz, primjerice neispravne UTF-8 bajtove; druga označava valjan niz koji se ne može preslikati u ciljnu reprezentaciju. catch (CharacterCodingException e) hvata obje vrste pogrešaka. Nemojte ih zamijeniti s UnsupportedCharsetException, koja znači da traženi skup znakova nije podržan.
Novi CharsetDecoder prema zadanim postavkama prijavljuje obje vrste pogrešaka; primjer izričito postavlja CodingErrorAction.REPORT. Poziv decode(ByteBuffer) s jednim argumentom tada izbacuje odgovarajuću podklasu iznimke. Streaming varijanta decode(ByteBuffer, CharBuffer, boolean) umjesto toga vraća CoderResult koji treba provjeriti. Postavke REPLACE i IGNORE zamjenjuju odnosno odbacuju pogrešne podatke, pa mijenjaju obradu pogrešaka i mogu uzrokovati gubitak informacija.
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) {
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());
}
}
}Rezultat
MalformedInputException
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.