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

CKTIS / Java

CharacterCodingException — erreurs d’encodage et de décodage

CharacterCodingException est une exception contrôlée de java.nio.charset qui étend IOException. Elle signale un échec lors de la conversion entre caractères et octets et fournit un type commun à intercepter pour les entrées mal formées et les caractères impossibles à représenter.

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

Syntaxe

public class CharacterCodingException extends IOException
public CharacterCodingException()

CharacterCodingException, dans java.nio.charset, est une exception contrôlée qui étend IOException. Elle concerne l’encodage des caractères en octets et le décodage des octets en caractères. Si une méthode appelée déclare cette exception, il faut l’intercepter ou déclarer un type approprié dans throws. La classe fournit le constructeur public sans argument CharacterCodingException().

Ses sous-classes directes sont MalformedInputException et UnmappableCharacterException. La première indique une séquence d’entrée invalide, comme des octets UTF-8 mal formés ; la seconde, une séquence valide qui ne peut pas être convertie dans la représentation cible. catch (CharacterCodingException e) intercepte ces deux types d’échec. Ne les confondez pas avec UnsupportedCharsetException, qui indique que le jeu de caractères demandé n’est pas pris en charge.

Un nouveau CharsetDecoder signale les deux types d’erreurs par défaut ; l’exemple définit explicitement CodingErrorAction.REPORT. L’appel à un argument decode(ByteBuffer) lance alors la sous-classe d’exception appropriée. En revanche, la surcharge en flux decode(ByteBuffer, CharBuffer, boolean) renvoie un CoderResult qu’il faut vérifier. Les options REPLACE et IGNORE remplacent ou écartent respectivement les données erronées : elles modifient donc le traitement des erreurs et peuvent entraîner une perte d’informations.

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

Résultat

MalformedInputException

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