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.