Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori