Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CharacterCodingException — błędy kodowania i dekodowania

CharacterCodingException to kontrolowany wyjątek z java.nio.charset, dziedziczący po IOException. Sygnalizuje błąd konwersji między znakami a bajtami i pozwala wspólnie obsłużyć niepoprawne dane wejściowe oraz brak możliwości odwzorowania znaków.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

public class CharacterCodingException extends IOException
public CharacterCodingException()

CharacterCodingException z pakietu java.nio.charset jest wyjątkiem kontrolowanym dziedziczącym po IOException. Dotyczy kodowania znaków na bajty i dekodowania bajtów na znaki. Gdy wywoływana metoda deklaruje ten wyjątek, należy go przechwycić albo zadeklarować odpowiedni typ w throws. Klasa udostępnia publiczny konstruktor bezargumentowy CharacterCodingException().

Jej bezpośrednie podklasy to MalformedInputException i UnmappableCharacterException. Pierwsza oznacza niepoprawną sekwencję wejściową, np. wadliwe bajty UTF-8; druga — poprawną sekwencję, której nie można odwzorować w docelowej reprezentacji. catch (CharacterCodingException e) przechwytuje oba rodzaje błędów. Nie należy mylić ich z UnsupportedCharsetException, który oznacza brak obsługi żądanego zestawu znaków.

Nowy CharsetDecoder domyślnie zgłasza oba rodzaje błędów; przykład jawnie ustawia CodingErrorAction.REPORT. Jednoargumentowe decode(ByteBuffer) zgłasza wtedy odpowiednią podklasę wyjątku. Wariant strumieniowy decode(ByteBuffer, CharBuffer, boolean) zwraca natomiast CoderResult, który trzeba sprawdzić. Ustawienia REPLACE i IGNORE odpowiednio zastępują błędne dane lub je pomijają, więc zmieniają sposób obsługi i mogą powodować utratę informacji.

Przykłady

import java.nio.ByteBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.CodingErrorAction;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) {
        var decoder = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPORT)
                .onUnmappableCharacter(CodingErrorAction.REPORT);
        byte[] bytes = {(byte) 0xC3, (byte) 0x28};

        try {
            decoder.decode(ByteBuffer.wrap(bytes));
            System.out.println("Decoded successfully");
        } catch (CharacterCodingException e) {
            System.out.println(e.getClass().getSimpleName());
        }
    }
}

Wynik

MalformedInputException

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

Źródła