Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CharacterCodingException — chyby kódování a dekódování

CharacterCodingException je kontrolovaná výjimka z java.nio.charset, která rozšiřuje IOException. Signalizuje selhání při převodu mezi znaky a bajty a nabízí společný typ pro zachycení chybného vstupu i nemapovatelných znaků.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

public class CharacterCodingException extends IOException
public CharacterCodingException()

CharacterCodingException z balíčku java.nio.charset je kontrolovaná výjimka rozšiřující IOException. Týká se kódování znaků na bajty a dekódování bajtů na znaky. Pokud volaná metoda tuto výjimku deklaruje, je třeba ji zachytit nebo deklarovat vhodný typ v throws. Třída poskytuje veřejný bezparametrický konstruktor CharacterCodingException().

Jejími přímými podtřídami jsou MalformedInputException a UnmappableCharacterException. První označuje neplatnou vstupní sekvenci, například chybné bajty UTF-8; druhá platnou sekvenci, kterou nelze převést na cílovou reprezentaci. catch (CharacterCodingException e) zachytí oba druhy selhání. Nezaměňujte je s UnsupportedCharsetException, která znamená, že požadovaná znaková sada není podporována.

Nový CharsetDecoder ve výchozím nastavení hlásí oba typy chyb; příklad výslovně nastavuje CodingErrorAction.REPORT. Volání decode(ByteBuffer) s jedním argumentem pak vyvolá příslušnou podtřídu výjimky. Proudová varianta decode(ByteBuffer, CharBuffer, boolean) naproti tomu vrací CoderResult, který je třeba zkontrolovat. Nastavení REPLACE a IGNORE chybná data nahrazují, respektive vynechávají, takže mění zpracování chyb a mohou způsobit ztrátu informací.

Pří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ýsledek

MalformedInputException

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje