Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje