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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.