Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

CodingErrorAction : signaler ou remplacer les entrées invalides

CodingErrorAction détermine comment un décodeur ou un encodeur de jeu de caractères traite les erreurs de codage. REPORT signale l’erreur à l’appelant, tandis que REPLACE substitue la valeur configurée et poursuit le traitement. Les politiques relatives aux entrées mal formées et aux caractères non représentables sont configurées séparément.

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

Syntaxe

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

CodingErrorAction, dans java.nio.charset, définit les politiques de gestion des erreurs pour CharsetDecoder et CharsetEncoder. Il s’agit d’une classe contenant des constantes qui représentent les actions disponibles, et non d’une déclaration enum. Une entrée mal formée ne respecte pas les règles de codage ; une erreur de caractère non représentable signifie qu’une séquence valide ne peut pas être représentée dans la sortie. Configurez ces politiques séparément avec onMalformedInput(...) et onUnmappableCharacter(...).

CodingErrorAction.REPORT signale une erreur : les méthodes de traitement incrémental des buffers renvoient un CoderResult approprié, tandis que les méthodes à un seul argument decode(...) et encode(...) lancent une sous-classe appropriée de CharacterCodingException. Les nouveaux décodeurs et encodeurs utilisent REPORT par défaut pour les deux catégories d’erreurs. Cela ne signifie pas que toutes les API de conversion de texte utilisent la même politique.

CodingErrorAction.REPLACE ignore l’entrée erronée, ajoute la valeur de remplacement et poursuit le traitement. Un décodeur insère du texte ; un encodeur, des octets. Modifiez cette valeur avec replaceWith(...). Cette opération entraîne une perte d’information : elle ne répare pas l’original. Choisissez REPORT si les erreurs doivent être détectées, et REPLACE uniquement si la substitution est acceptable. L’exemple Java SE 21 compare les deux actions sur un octet UTF-8 invalide et définit explicitement ? pour rendre le résultat lisible.

Exemples

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

Résultat

REPORT: MalformedInputException
REPLACE: ?A

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources