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

CKTIS / Java

CharsetDecoder — décoder des octets avec contrôle des erreurs

CharsetDecoder convertit les octets d’un jeu de caractères choisi en caractères Unicode. Il permet de configurer séparément le traitement des séquences mal formées et non représentables : signaler les erreurs, remplacer les données ou les ignorer.

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

Syntaxe

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

java.nio.charset.CharsetDecoder convertit des octets en caractères Unicode ; créez-le avec charset.newDecoder(). Cette entrée concerne Java SE 21 ; les versions des environnements d’exécution du dépôt et de production ne sont pas attestées.

CharsetDecoder.onMalformedInput définit le traitement des séquences non valides dans le jeu de caractères. CharsetDecoder.onUnmappableCharacter concerne les séquences valides qui ne correspondent à aucun caractère Unicode. Les deux méthodes acceptent CodingErrorAction : REPORT signale une erreur, REPLACE remplace les données erronées et IGNORE les écarte. Le remplacement et l’omission entraînent une perte d’information.

CharsetDecoder.decode(ByteBuffer) renvoie un CharBuffer ; avec REPORT, les erreurs sont levées sous forme d’exceptions de la famille CharacterCodingException. La surcharge decode(ByteBuffer, CharBuffer, boolean) permet le traitement incrémental et renvoie un CoderResult qui doit être traité.

L’exemple utilise 0xFF, un octet UTF-8 invalide. Il signale d’abord l’erreur, puis remplace l’octet par ?. Il illustre une entrée mal formée, et non une séquence non représentable ; la deuxième stratégie reste réglée sur REPORT.

Exemples

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

Résultat

REPORT: MalformedInputException
REPLACE: A?B

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