Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CodingErrorAction: hlášení nebo nahrazování neplatného vstupu

CodingErrorAction určuje, jak dekodér nebo kodér znakové sady zpracuje chyby kódování. REPORT zpřístupní chybu volajícímu, zatímco REPLACE nahradí chybnou část nakonfigurovanou hodnotou a pokračuje ve zpracování. Zásady pro chybný vstup a nepřevoditelné znaky se nastavují samostatně.

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

Syntaxe

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

CodingErrorAction z java.nio.charset definuje zásady zpracování chyb pro CharsetDecoder a CharsetEncoder. Jde o třídu s konstantami představujícími dostupné akce, nikoli o deklaraci enum. Chybný vstup porušuje pravidla kódování; chyba nepřevoditelného znaku znamená, že platnou sekvenci nelze vyjádřit ve výstupu. Tyto zásady nastavte nezávisle pomocí onMalformedInput(...) a onUnmappableCharacter(...).

CodingErrorAction.REPORT ohlásí chybu: metody pro přírůstkové zpracování bufferů vracejí odpovídající CoderResult, zatímco metody decode(...) a encode(...) s jedním argumentem vyhazují odpovídající podtřídu CharacterCodingException. Nové dekodéry a kodéry používají ve výchozím nastavení REPORT pro obě kategorie chyb. To neznamená, že každé API pro převod textu používá stejné zásady.

CodingErrorAction.REPLACE přeskočí chybný vstup, přidá náhradní hodnotu a pokračuje. Dekodér vloží text, kodér bajty. Tuto hodnotu změňte pomocí replaceWith(...). Dochází tak ke ztrátě informací; původní data se neopravují. Zvolte REPORT, pokud je třeba chyby zjistit, a REPLACE pouze tehdy, pokud je nahrazování přijatelné. Příklad pro Java SE 21 porovnává obě akce na neplatném bajtu UTF-8 a výslovně nastavuje ?, aby byl výstup čitelný.

Příklady

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

Výsledek

REPORT: MalformedInputException
REPLACE: ?A

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje