CKTIS / Java
CharsetDecoder — Bytes mit Fehlerkontrolle dekodieren
CharsetDecoder wandelt Bytes einer ausgewählten Zeichenkodierung in Unicode-Zeichen um. Für fehlerhafte und nicht abbildbare Sequenzen lässt sich die Behandlung getrennt festlegen: Fehler melden, Eingaben ersetzen oder ignorieren.
Version: Documentation target: Java SE 21; repository and production runtime versions are not attested.
Syntax
CharsetDecoder decoder = charset.newDecoder()
.onMalformedInput(CodingErrorAction.REPORT)
.onUnmappableCharacter(CodingErrorAction.REPORT);
CharBuffer text = decoder.decode(input);java.nio.charset.CharsetDecoder wandelt Bytes in Unicode-Zeichen um; erstellen Sie ihn mit charset.newDecoder(). Dieser Eintrag bezieht sich auf Java SE 21; die Versionen der Repository- und Produktionslaufzeitumgebungen sind nicht bestätigt.
CharsetDecoder.onMalformedInput legt fest, wie mit Sequenzen umzugehen ist, die in der Zeichenkodierung ungültig sind. CharsetDecoder.onUnmappableCharacter betrifft gültige Sequenzen, denen keine Unicode-Zeichen zugeordnet werden können. Beide Methoden akzeptieren CodingErrorAction: REPORT meldet einen Fehler, REPLACE ersetzt fehlerhafte Eingaben und IGNORE verwirft sie. Ersetzen und Verwerfen führen zu Informationsverlust.
CharsetDecoder.decode(ByteBuffer) gibt einen CharBuffer zurück; bei REPORT werden Fehler als Ausnahmen aus der CharacterCodingException-Familie ausgelöst. Die Überladung decode(ByteBuffer, CharBuffer, boolean) unterstützt die inkrementelle Verarbeitung und gibt ein CoderResult zurück, das behandelt werden muss.
Das Beispiel verwendet 0xFF, ein ungültiges UTF-8-Byte. Zuerst wird der Fehler gemeldet, anschließend das Byte durch ? ersetzt. Dies veranschaulicht fehlerhafte Eingaben, keine nicht abbildbare Sequenz; die zweite Richtlinie bleibt auf REPORT eingestellt.
Beispiele
import java.nio.ByteBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.CharsetDecoder;
import java.nio.charset.CodingErrorAction;
import java.nio.charset.StandardCharsets;
public class DecoderDemo {
public static void main(String[] args) throws CharacterCodingException {
byte[] bytes = {65, (byte) 0xFF, 66};
CharsetDecoder decoder = StandardCharsets.UTF_8.newDecoder()
.onMalformedInput(CodingErrorAction.REPORT)
.onUnmappableCharacter(CodingErrorAction.REPORT);
try {
decoder.decode(ByteBuffer.wrap(bytes));
} catch (CharacterCodingException ex) {
System.out.println("REPORT: " + ex.getClass().getSimpleName());
}
decoder.reset();
decoder.onMalformedInput(CodingErrorAction.REPLACE)
.replaceWith("?");
System.out.println("REPLACE: " + decoder.decode(ByteBuffer.wrap(bytes)));
}
}Ergebnis
REPORT: MalformedInputException REPLACE: A?B
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.