Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

CharacterCodingException — errori di codifica e decodifica

CharacterCodingException è un’eccezione controllata di java.nio.charset che estende IOException. Segnala un errore nella conversione tra caratteri e byte e fornisce un tipo comune da intercettare per input malformati e caratteri non mappabili.

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

Sintassi

public class CharacterCodingException extends IOException
public CharacterCodingException()

CharacterCodingException, nel pacchetto java.nio.charset, è un’eccezione controllata che estende IOException. Riguarda la codifica dei caratteri in byte e la decodifica dei byte in caratteri. Se un metodo chiamato dichiara questa eccezione, occorre intercettarla oppure dichiarare un tipo appropriato in throws. La classe fornisce il costruttore pubblico senza argomenti CharacterCodingException().

Le sue sottoclassi dirette sono MalformedInputException e UnmappableCharacterException. La prima indica una sequenza di input non valida, per esempio byte UTF-8 malformati; la seconda una sequenza valida che non può essere convertita nella rappresentazione di destinazione. catch (CharacterCodingException e) intercetta entrambi i tipi di errore. Non vanno confusi con UnsupportedCharsetException, che indica che il charset richiesto non è supportato.

Un nuovo CharsetDecoder segnala entrambi i tipi di errore per impostazione predefinita; l’esempio imposta esplicitamente CodingErrorAction.REPORT. La chiamata a un argomento decode(ByteBuffer) genera quindi la sottoclasse appropriata dell’eccezione. La versione in streaming decode(ByteBuffer, CharBuffer, boolean), invece, restituisce un CoderResult che deve essere controllato. Le impostazioni REPLACE e IGNORE sostituiscono o scartano rispettivamente i dati errati: cambiano quindi la gestione degli errori e possono causare perdita di informazioni.

Esempi

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) {
        var decoder = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPORT)
                .onUnmappableCharacter(CodingErrorAction.REPORT);
        byte[] bytes = {(byte) 0xC3, (byte) 0x28};

        try {
            decoder.decode(ByteBuffer.wrap(bytes));
            System.out.println("Decoded successfully");
        } catch (CharacterCodingException e) {
            System.out.println(e.getClass().getSimpleName());
        }
    }
}

Risultato

MalformedInputException

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