Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

CharsetDecoder — dekódovanie bajtov s kontrolou chýb

CharsetDecoder prevádza bajty zvoleného znakového kódovania na znaky Unicode. Umožňuje samostatne nastaviť spracovanie chybných a nezobraziteľných sekvencií: oznámiť chybu, nahradiť vstup alebo ho ignorovať.

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

Syntax

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

java.nio.charset.CharsetDecoder prevádza bajty na znaky Unicode; vytvorte ho pomocou charset.newDecoder(). Tento záznam sa týka Java SE 21; verzie behového prostredia repozitára a produkcie nie sú potvrdené.

CharsetDecoder.onMalformedInput určuje reakciu na sekvencie neplatné v danom znakovom kódovaní. CharsetDecoder.onUnmappableCharacter sa týka platných sekvencií, ktoré nemožno previesť na znaky Unicode. Obe metódy prijímajú CodingErrorAction: REPORT oznámi chybu, REPLACE nahradí chybné vstupné údaje a IGNORE ich zahodí. Nahrádzanie aj vynechávanie vedie k strate informácií.

CharsetDecoder.decode(ByteBuffer) vracia CharBuffer; pri nastavení REPORT sa chyby vyhadzujú ako výnimky z rodiny CharacterCodingException. Preťaženie decode(ByteBuffer, CharBuffer, boolean) podporuje postupné spracovanie a vracia CoderResult, ktorý treba spracovať.

Príklad používa 0xFF, neplatný bajt UTF-8. Najprv oznámi chybu a potom bajt nahradí znakom ?. Ide o ukážku chybného vstupu, nie nezobraziteľnej sekvencie; druhá zásada zostáva nastavená na REPORT.

Prí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ýsledok

REPORT: MalformedInputException
REPLACE: A?B

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje