Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori