KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

CharacterCodingException — coderings- en decoderingsfouten

CharacterCodingException is een gecontroleerde uitzondering uit java.nio.charset die IOException uitbreidt. De uitzondering geeft een fout aan bij het omzetten tussen tekens en bytes en biedt één gemeenschappelijk catch-type voor ongeldige invoer en niet-afbeeldbare tekens.

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

Syntax

public class CharacterCodingException extends IOException
public CharacterCodingException()

CharacterCodingException uit java.nio.charset is een gecontroleerde uitzondering die IOException uitbreidt. De uitzondering heeft betrekking op het coderen van tekens naar bytes en het decoderen van bytes naar tekens. Als een aangeroepen methode deze uitzondering declareert, moet je die afvangen of een passend type in throws declareren. De klasse biedt de publieke constructor zonder argumenten CharacterCodingException().

De directe subklassen zijn MalformedInputException en UnmappableCharacterException. De eerste staat voor een ongeldige invoersequentie, zoals ongeldige UTF-8-bytes; de tweede voor een geldige sequentie die niet naar de doelrepresentatie kan worden omgezet. catch (CharacterCodingException e) vangt beide soorten fouten op. Verwar ze niet met UnsupportedCharsetException, die aangeeft dat de gevraagde tekenset niet wordt ondersteund.

Een nieuwe CharsetDecoder meldt standaard beide fouttypen; het voorbeeld stelt expliciet CodingErrorAction.REPORT in. De aanroep met één argument decode(ByteBuffer) werpt dan de passende subklasse van de uitzondering. De streaming-overload decode(ByteBuffer, CharBuffer, boolean) geeft daarentegen een CoderResult terug dat gecontroleerd moet worden. De instellingen REPLACE en IGNORE vervangen respectievelijk onjuiste gegevens of laten ze weg. Ze veranderen dus de foutafhandeling en kunnen informatieverlies veroorzaken.

Voorbeelden

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());
        }
    }
}

Resultaat

MalformedInputException

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen