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

CKTIS / Java

CharsetDecoder — декодиране на байтове с контрол на грешките

CharsetDecoder преобразува байтове от избрана кодировка в Unicode символи. Позволява отделно да се настрои обработката на невалидни и немапируеми последователности: докладване на грешки, замяна на входните данни или игнорирането им.

Версия: Documentation target: Java SE 21; repository and production runtime versions are not attested.

Синтаксис

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

java.nio.charset.CharsetDecoder преобразува байтове в Unicode символи; създайте го чрез charset.newDecoder(). Тази статия се отнася за Java SE 21; версиите на средите за изпълнение в хранилището и в продукция не са потвърдени.

CharsetDecoder.onMalformedInput задава реакцията при последователности, които са невалидни за кодировката. CharsetDecoder.onUnmappableCharacter се отнася за валидни последователности, които нямат съответствие в Unicode символи. И двата метода приемат CodingErrorAction: REPORT съобщава за грешка, REPLACE заменя невалидните входни данни, а IGNORE ги премахва. Заместването и пропускането водят до загуба на информация.

CharsetDecoder.decode(ByteBuffer) връща CharBuffer; при REPORT грешките се хвърлят като изключения от семейството CharacterCodingException. Претовареният метод decode(ByteBuffer, CharBuffer, boolean) поддържа постепенно обработване и връща CoderResult, който трябва да бъде обработен.

Примерът използва 0xFF — невалиден UTF-8 байт. Първо съобщава за грешката, а след това заменя байта с ?. Това демонстрира невалидни входни данни, а не немапируема последователност; втората политика остава зададена на REPORT.

Примери

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

Резултат

REPORT: MalformedInputException
REPLACE: A?B

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

Източници