Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

CodingErrorAction: segnalare o sostituire gli input non validi

CodingErrorAction stabilisce come un decoder o encoder di charset gestisce gli errori di codifica. REPORT comunica l’errore al chiamante, mentre REPLACE sostituisce la parte difettosa con il valore configurato e prosegue l’elaborazione. Le politiche per input malformati e caratteri non rappresentabili si configurano separatamente.

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

Sintassi

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

CodingErrorAction, in java.nio.charset, definisce le politiche di gestione degli errori per CharsetDecoder e CharsetEncoder. È una classe con costanti che rappresentano le azioni disponibili, non una dichiarazione enum. Un input malformato viola le regole di codifica; un errore di carattere non rappresentabile indica che una sequenza valida non può essere rappresentata nell’output. Configura queste politiche separatamente con onMalformedInput(...) e onUnmappableCharacter(...).

CodingErrorAction.REPORT segnala un errore: i metodi di elaborazione incrementale dei buffer restituiscono un CoderResult appropriato, mentre i metodi con un solo argomento decode(...) e encode(...) lanciano una sottoclasse appropriata di CharacterCodingException. I nuovi decoder e encoder usano REPORT come impostazione predefinita per entrambe le categorie di errore. Questo non significa che ogni API di conversione del testo adotti la stessa politica.

CodingErrorAction.REPLACE salta l’input errato, aggiunge il valore sostitutivo e continua. Un decoder inserisce testo; un encoder, byte. Modifica il valore con replaceWith(...). L’operazione comporta una perdita di informazioni e non ripara l’originale. Scegli REPORT quando gli errori devono essere rilevati e REPLACE solo se la sostituzione è accettabile. L’esempio per Java SE 21 confronta entrambe le azioni con un byte UTF-8 non valido e imposta esplicitamente ? per rendere leggibile l’output.

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

Risultato

REPORT: MalformedInputException
REPLACE: ?A

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