База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

CharacterCodingException — грешки при кодиране и декодиране

CharacterCodingException е проверявано изключение от java.nio.charset, което разширява IOException. То сигнализира за неуспех при преобразуване между символи и байтове и осигурява общ тип за прихващане на невалиден вход и символи, които не могат да бъдат съпоставени.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

public class CharacterCodingException extends IOException
public CharacterCodingException()

CharacterCodingException от пакета java.nio.charset е проверявано изключение, което разширява IOException. То се отнася до кодирането на символи в байтове и декодирането на байтове в символи. Ако извикан метод декларира това изключение, трябва да го прихванете или да декларирате подходящ тип в throws. Класът предоставя публичния конструктор без аргументи CharacterCodingException().

Неговите преки подкласове са MalformedInputException и UnmappableCharacterException. Първият означава невалидна входна последователност, например неправилни UTF-8 байтове; вторият — валидна последователност, която не може да бъде съпоставена с целевото представяне. catch (CharacterCodingException e) прихваща и двата вида грешки. Не ги бъркайте с UnsupportedCharsetException, което означава, че заявената кодировка не се поддържа.

Нов CharsetDecoder по подразбиране съобщава и за двата вида грешки; примерът изрично задава CodingErrorAction.REPORT. Тогава извикването с един аргумент decode(ByteBuffer) хвърля подходящия подклас на изключението. Потоковият вариант decode(ByteBuffer, CharBuffer, boolean) вместо това връща CoderResult, който трябва да бъде проверен. Настройките REPLACE и IGNORE съответно заменят или пропускат грешните данни, така че променят обработката на грешките и могат да доведат до загуба на информация.

Примери

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

Резултат

MalformedInputException

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници