CKTIS / Java
CharacterCodingException — Kodierungs- und Dekodierungsfehler
CharacterCodingException ist eine geprüfte Ausnahme aus java.nio.charset, die IOException erweitert. Sie signalisiert einen Fehler bei der Umwandlung zwischen Zeichen und Bytes und bietet einen gemeinsamen Catch-Typ für fehlerhafte Eingaben und nicht zuordenbare Zeichen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
public class CharacterCodingException extends IOException
public CharacterCodingException()CharacterCodingException aus java.nio.charset ist eine geprüfte Ausnahme, die IOException erweitert. Sie betrifft das Kodieren von Zeichen in Bytes und das Dekodieren von Bytes in Zeichen. Deklariert eine aufgerufene Methode diese Ausnahme, muss sie abgefangen oder ein passender Typ in throws deklariert werden. Die Klasse stellt den öffentlichen parameterlosen Konstruktor CharacterCodingException() bereit.
Ihre direkten Unterklassen sind MalformedInputException und UnmappableCharacterException. Die erste steht für eine ungültige Eingabesequenz, etwa fehlerhafte UTF-8-Bytes; die zweite für eine gültige Sequenz, die sich nicht auf die Zielrepräsentation abbilden lässt. catch (CharacterCodingException e) fängt beide Fehlerarten ab. Nicht damit zu verwechseln ist UnsupportedCharsetException, die bedeutet, dass der angeforderte Zeichensatz nicht unterstützt wird.
Ein neuer CharsetDecoder meldet standardmäßig beide Fehlerarten; das Beispiel setzt CodingErrorAction.REPORT ausdrücklich. Der einargumentige Aufruf decode(ByteBuffer) wirft dann die passende Unterklasse der Ausnahme. Die Streaming-Überladung decode(ByteBuffer, CharBuffer, boolean) gibt dagegen ein CoderResult zurück, das geprüft werden muss. Die Einstellungen REPLACE und IGNORE ersetzen beziehungsweise verwerfen fehlerhafte Eingaben. Sie ändern daher die Fehlerbehandlung und können zu Informationsverlust führen.
Beispiele
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());
}
}
}Ergebnis
MalformedInputException
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.