CKTIS / Java
CharsetDecoder — dekodiranje bajtov z nadzorom napak
CharsetDecoder pretvori bajte izbrane znakovne kodne tabele v znake Unicode. Omogoča ločeno nastavitev obravnave nepravilnih in nemapljivih zaporedij: poročanje o napakah, zamenjavo ali prezrtje vhodnih podatkov.
Različica: Documentation target: Java SE 21; repository and production runtime versions are not attested.
Sintaksa
CharsetDecoder decoder = charset.newDecoder()
.onMalformedInput(CodingErrorAction.REPORT)
.onUnmappableCharacter(CodingErrorAction.REPORT);
CharBuffer text = decoder.decode(input);java.nio.charset.CharsetDecoder pretvori bajte v znake Unicode; ustvarite ga z charset.newDecoder(). Ta vnos obravnava Java SE 21; različice izvajalnih okolij repozitorija in produkcije niso potrjene.
CharsetDecoder.onMalformedInput določa odziv na zaporedja, ki v znakovni kodni tabeli niso veljavna. CharsetDecoder.onUnmappableCharacter zadeva veljavna zaporedja, ki jih ni mogoče preslikati v znake Unicode. Obe metodi sprejemata CodingErrorAction: REPORT javi napako, REPLACE nadomesti napačne vhodne podatke, IGNORE pa jih zavrže. Zamenjava in izpust povzročita izgubo informacij.
CharsetDecoder.decode(ByteBuffer) vrne CharBuffer; pri nastavitvi REPORT se napake sprožijo kot izjeme iz družine CharacterCodingException. Preobremenitev decode(ByteBuffer, CharBuffer, boolean) podpira postopno obdelavo in vrne CoderResult, ki ga je treba obravnavati.
Primer uporablja 0xFF, neveljaven bajt UTF-8. Najprej javi napako, nato bajt zamenja z ?. To prikazuje nepravilne vhodne podatke, ne nemapljivega zaporedja; druga politika ostane nastavljena na REPORT.
Primeri
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)));
}
}Rezultat
REPORT: MalformedInputException REPLACE: A?B
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.