CKTIS / Java
CharsetDecoder — dekodiranje bajtova uz kontrolu pogrešaka
CharsetDecoder pretvara bajtove odabranog skupa znakova u Unicode znakove. Omogućuje zasebno postavljanje načina obrade neispravnih i nemapiranih nizova: prijavljivanje pogrešaka, zamjenu ulaznih podataka ili njihovo zanemarivanje.
Verzija: 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 pretvara bajtove u Unicode znakove; stvorite ga pomoću charset.newDecoder(). Ovaj se unos odnosi na Java SE 21; verzije izvršnih okruženja repozitorija i produkcije nisu potvrđene.
CharsetDecoder.onMalformedInput određuje reakciju na nizove koji nisu valjani u odabranom skupu znakova. CharsetDecoder.onUnmappableCharacter odnosi se na valjane nizove koji se ne mogu mapirati na Unicode znakove. Obje metode prihvaćaju CodingErrorAction: REPORT prijavljuje pogrešku, REPLACE zamjenjuje neispravne ulazne podatke, a IGNORE ih odbacuje. Zamjena i izostavljanje uzrokuju gubitak informacija.
CharsetDecoder.decode(ByteBuffer) vraća CharBuffer; uz postavku REPORT pogreške se izbacuju kao iznimke iz obitelji CharacterCodingException. Preopterećenje decode(ByteBuffer, CharBuffer, boolean) podržava postupnu obradu i vraća CoderResult koji treba obraditi.
Primjer upotrebljava 0xFF, nevaljani UTF-8 bajt. Najprije prijavljuje pogrešku, a zatim zamjenjuje bajt znakom ?. To prikazuje neispravan ulaz, a ne nemapirani niz; druga je politika i dalje postavljena na REPORT.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.