Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

CharsetDecoder — decodificare byte con controllo degli errori

CharsetDecoder converte i byte di un set di caratteri selezionato in caratteri Unicode. Consente di configurare separatamente la gestione delle sequenze malformate e non mappabili: segnalare gli errori, sostituire l’input o ignorarlo.

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

Sintassi

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

java.nio.charset.CharsetDecoder converte i byte in caratteri Unicode; crealo tramite charset.newDecoder(). Questa voce riguarda Java SE 21; le versioni degli ambienti di runtime del repository e di produzione non sono attestate.

CharsetDecoder.onMalformedInput controlla le sequenze non valide nel set di caratteri. CharsetDecoder.onUnmappableCharacter riguarda le sequenze valide che non corrispondono a caratteri Unicode. Entrambi i metodi accettano CodingErrorAction: REPORT segnala un errore, REPLACE sostituisce i dati errati e IGNORE li scarta. La sostituzione e l’omissione comportano una perdita di informazioni.

CharsetDecoder.decode(ByteBuffer) restituisce un CharBuffer; con REPORT, gli errori vengono lanciati come eccezioni della famiglia CharacterCodingException. L’overload decode(ByteBuffer, CharBuffer, boolean) supporta l’elaborazione incrementale e restituisce un CoderResult che deve essere gestito.

L’esempio usa 0xFF, un byte UTF-8 non valido. Prima segnala l’errore, poi sostituisce il byte con ?. Dimostra un input malformato, non una sequenza non mappabile; la seconda policy rimane impostata su REPORT.

Esempi

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

Risultato

REPORT: MalformedInputException
REPLACE: A?B

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti