CKTIS / Java
CharsetDecoder — bytes decoderen met foutcontrole
CharsetDecoder zet bytes uit een geselecteerde tekencodering om in Unicode-tekens. U kunt afzonderlijk instellen hoe ongeldige en niet-afbeeldbare reeksen worden afgehandeld: fouten melden, invoer vervangen of invoer negeren.
Versie: 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 zet bytes om in Unicode-tekens; maak er een aan met charset.newDecoder(). Dit artikel is bedoeld voor Java SE 21; de versies van de runtimeomgevingen van de repository en productie zijn niet bevestigd.
CharsetDecoder.onMalformedInput bepaalt hoe reeksen worden behandeld die ongeldig zijn in de tekencodering. CharsetDecoder.onUnmappableCharacter geldt voor geldige reeksen die niet naar Unicode-tekens kunnen worden omgezet. Beide methoden accepteren CodingErrorAction: REPORT meldt een fout, REPLACE vervangt onjuiste invoer en IGNORE laat die weg. Vervangen en weglaten leiden tot informatieverlies.
CharsetDecoder.decode(ByteBuffer) retourneert een CharBuffer; met REPORT worden fouten als uitzonderingen uit de familie CharacterCodingException gegooid. De overload decode(ByteBuffer, CharBuffer, boolean) ondersteunt incrementele verwerking en retourneert een CoderResult dat moet worden afgehandeld.
Het voorbeeld gebruikt 0xFF, een ongeldige UTF-8-byte. Eerst wordt de fout gemeld, daarna wordt de byte vervangen door ?. Dit demonstreert ongeldige invoer, niet een niet-afbeeldbare reeks; het tweede beleid blijft ingesteld op REPORT.
Voorbeelden
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)));
}
}Resultaat
REPORT: MalformedInputException REPLACE: A?B
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.