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

CKTIS / Java

CodingErrorAction: съобщаване или заместване на невалиден вход

CodingErrorAction определя как декодер или кодер на набор от знаци обработва грешки при кодиране. REPORT съобщава грешката на извикващия код, а REPLACE заменя невалидния фрагмент с конфигурираната стойност и продължава обработката. Правилата за неправилен вход и немапируеми знаци се настройват поотделно.

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

Синтаксис

coder.onMalformedInput(CodingErrorAction.REPORT);
coder.onUnmappableCharacter(CodingErrorAction.REPLACE);

CodingErrorAction от java.nio.charset задава правила за обработка на грешки за CharsetDecoder и CharsetEncoder. Това е клас с константи, представящи наличните действия, а не декларация enum. Неправилният вход нарушава правилата за кодиране; грешка с немапируем знак означава, че валидна последователност не може да бъде представена в изхода. Настройте тези правила независимо чрез onMalformedInput(...) и onUnmappableCharacter(...).

CodingErrorAction.REPORT съобщава за грешка: методите за постепенно обработване на буфери връщат подходящ CoderResult, докато методите с един аргумент decode(...) и encode(...) хвърлят подходящ подклас на CharacterCodingException. Новите декодери и кодери използват REPORT по подразбиране и за двете категории грешки. Това не означава, че всеки API за преобразуване на текст използва същото правило.

CodingErrorAction.REPLACE пропуска грешния вход, добавя заместващата стойност и продължава. Декодерът вмъква текст, а кодерът — байтове. Променете стойността с replaceWith(...). Това води до загуба на информация, а не до поправяне на оригинала. Изберете REPORT, когато грешките трябва да бъдат откривани, и REPLACE само ако заместването е приемливо. Примерът за Java SE 21 сравнява двете действия с невалиден UTF-8 байт и изрично задава ?, за да направи резултата четлив.

Примери

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) throws CharacterCodingException {
        byte[] input = {(byte) 0xFF, 0x41};

        var strict = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPORT);
        try {
            strict.decode(ByteBuffer.wrap(input));
        } catch (CharacterCodingException e) {
            System.out.println("REPORT: " + e.getClass().getSimpleName());
        }

        var tolerant = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPLACE)
                .replaceWith("?");
        System.out.println("REPLACE: " + tolerant.decode(ByteBuffer.wrap(input)));
    }
}

Резултат

REPORT: MalformedInputException
REPLACE: ?A

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

Източници