Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CharsetDecoder — dekodowanie bajtów z kontrolą błędów

CharsetDecoder przekształca bajty wybranego kodowania w znaki Unicode. Pozwala osobno ustawić obsługę niepoprawnych sekwencji i sekwencji bez odwzorowania: zgłaszanie błędu, zastępowanie lub pomijanie.

Wersja: Documentation target: Java SE 21; repository and production runtime versions are not attested.

Składnia

CharsetDecoder decoder = charset.newDecoder()
    .onMalformedInput(CodingErrorAction.REPORT)
    .onUnmappableCharacter(CodingErrorAction.REPORT);
CharBuffer text = decoder.decode(input);

java.nio.charset.CharsetDecoder przekształca bajty w znaki Unicode; utwórz go przez charset.newDecoder(). Opis dotyczy Java SE 21; wersje środowisk repozytorium i produkcji nie są potwierdzone.

CharsetDecoder.onMalformedInput ustawia reakcję na sekwencję niedozwoloną w danym kodowaniu. CharsetDecoder.onUnmappableCharacter dotyczy sekwencji poprawnej, lecz bez odwzorowania na znaki Unicode. Obie metody przyjmują CodingErrorAction: REPORT zgłasza błąd, REPLACE zastępuje błędne dane, a IGNORE je usuwa. Zastępowanie i pomijanie tracą informację.

CharsetDecoder.decode(ByteBuffer) zwraca CharBuffer; przy REPORT błędy są zgłaszane jako wyjątki z rodziny CharacterCodingException. Przeciążenie decode(ByteBuffer, CharBuffer, boolean) służy do pracy przyrostowej i zwraca CoderResult, który trzeba obsłużyć.

Przykład używa 0xFF, czyli niepoprawnego bajtu UTF-8. Najpierw zgłasza błąd, potem zastępuje bajt przez ?. To demonstracja błędnego wejścia, nie braku odwzorowania; druga polityka pozostaje ustawiona na REPORT.

Przykłady

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)));
    }
}

Wynik

REPORT: MalformedInputException
REPLACE: A?B

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła