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

CKTIS / Java

CharsetDecoder — dekódování bajtů s kontrolou chyb

CharsetDecoder převádí bajty zvoleného znakového kódování na znaky Unicode. Umožňuje zvlášť nastavit, jak naložit s neplatnými sekvencemi a jak s platnými sekvencemi, které nemají odpovídající znaky v Unicode: ohlásit chybu, nahradit vstup nebo jej vynechat.

Verze: Documentation target: Java SE 21; repository and production runtime versions are not attested.

Syntaxe

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

java.nio.charset.CharsetDecoder převádí bajty na znaky Unicode; vytvořte jej pomocí charset.newDecoder(). Tento záznam se týká Java SE 21; verze běhových prostředí repozitáře a produkce nejsou potvrzeny.

CharsetDecoder.onMalformedInput určuje reakci na sekvence neplatné v daném znakovém kódování. CharsetDecoder.onUnmappableCharacter se týká platných sekvencí, které nelze převést na znaky Unicode. Obě metody přijímají CodingErrorAction: REPORT oznámí chybu, REPLACE chybné vstupní údaje nahradí a IGNORE je zahodí. Nahrazení i vynechání znamená ztrátu informací.

CharsetDecoder.decode(ByteBuffer) vrací CharBuffer; při nastavení REPORT se chyby vyhazují jako výjimky z rodiny CharacterCodingException. Přetížení decode(ByteBuffer, CharBuffer, boolean) podporuje postupné zpracování a vrací CoderResult, který je nutné zpracovat.

Příklad používá 0xFF, neplatný bajt UTF-8. Nejprve oznámí chybu a potom bajt nahradí znakem ?. Jde o ukázku neplatného vstupu, nikoli platné sekvence bez odpovídajících znaků v Unicode; druhá zásada zůstává nastavena na REPORT.

Příklady

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

Výsledek

REPORT: MalformedInputException
REPLACE: A?B

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