CKTIS / Java
CharacterCodingException — napake pri kodiranju in dekodiranju
CharacterCodingException je preverjena izjema iz java.nio.charset, ki razširja IOException. Označuje napako pri pretvorbi med znaki in bajti ter zagotavlja skupni tip za prestrezanje napačnih vhodnih podatkov in znakov, ki jih ni mogoče preslikati.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public class CharacterCodingException extends IOException
public CharacterCodingException()CharacterCodingException iz paketa java.nio.charset je preverjena izjema, ki razširja IOException. Nanaša se na kodiranje znakov v bajte in dekodiranje bajtov v znake. Če klicana metoda deklarira to izjemo, jo je treba prestreči ali pa v throws deklarirati ustrezen tip. Razred ponuja javni konstruktor brez argumentov CharacterCodingException().
Njeni neposredni podrazredi so MalformedInputException in UnmappableCharacterException. Prvi označuje neveljavno vhodno zaporedje, na primer nepravilne bajte UTF-8; drugi pa veljavno zaporedje, ki ga ni mogoče preslikati v ciljno predstavitev. catch (CharacterCodingException e) prestreže obe vrsti napak. Ne zamenjujte ju z UnsupportedCharsetException, ki pomeni, da zahtevani nabor znakov ni podprt.
Nov CharsetDecoder privzeto sporoča obe vrsti napak; primer izrecno nastavi CodingErrorAction.REPORT. Klic decode(ByteBuffer) z enim argumentom nato sproži ustrezni podrazred izjeme. Pretočna različica decode(ByteBuffer, CharBuffer, boolean) pa vrne CoderResult, ki ga je treba preveriti. Nastavitvi REPLACE in IGNORE napačne podatke zamenjata oziroma prezreta, zato spremenita obravnavo napak in lahko povzročita izgubo informacij.
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) {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.