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

CKTIS / Java

Charset — encoder et décoder du texte

java.nio.charset.Charset décrit une correspondance entre les unités de code Unicode et les octets. Découvrez comment Charset.forName sélectionne un encodage et comment créer un décodeur et un encodeur avec une gestion explicite des erreurs.

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

Syntaxe

Charset cs = Charset.forName("UTF-8");
CharsetDecoder decoder = cs.newDecoder();
CharsetEncoder encoder = cs.newEncoder();

java.nio.charset.Charset décrit une correspondance nommée entre des séquences d’unités de code Unicode de 16 bits et des octets. Le décodage transforme les octets en caractères, tandis que l’encodage transforme les caractères en octets. L’encodage doit correspondre au format des données ; un mauvais choix peut produire un texte incorrect sans signaler d’erreur.

Charset.forName("UTF-8") recherche un encodage par son nom ou son alias, sans tenir compte de la casse. Un nom illégal provoque IllegalCharsetNameException, tandis qu’un encodage non pris en charge provoque UnsupportedCharsetException. Pour un encodage fixe, vous pouvez utiliser StandardCharsets.UTF_8.

Charset.newDecoder() crée un CharsetDecoder qui convertit un ByteBuffer en CharBuffer. Si l’objet Charset prend en charge l’encodage, Charset.newEncoder() crée un CharsetEncoder pour le sens inverse. Certains objets Charset ne prennent en charge que le décodage : si canEncode() renvoie false, newEncoder() lève une UnsupportedOperationException. Un objet Charset est immuable et peut être partagé entre plusieurs threads en toute sécurité, mais les encodeurs et les décodeurs ne peuvent pas être utilisés simultanément par plusieurs threads en toute sécurité.

Les nouveaux encodeurs et décodeurs utilisent par défaut CodingErrorAction.REPORT en cas d’entrée mal formée ou de caractère non représentable. Leurs méthodes encode et decode à un argument peuvent donc lever CharacterCodingException. En revanche, les méthodes pratiques Charset.encode et Charset.decode remplacent les données problématiques. Utilisez onMalformedInput et onUnmappableCharacter pour choisir explicitement une stratégie de gestion des erreurs.

L’exemple encode caf\u00e9 en UTF-8, puis décode le résultat. Il vérifie le nombre d’octets et l’égalité du texte sans dépendre de son affichage dans le terminal. Le résultat de l’encodage est déjà prêt à être lu ; ne lui appliquez pas flip() avant le décodage.

Exemples

import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.Charset;

public class CharsetDemo {
    public static void main(String[] args) throws CharacterCodingException {
        Charset cs = Charset.forName("UTF-8");
        String text = "caf\u00e9";
        ByteBuffer bytes = cs.newEncoder().encode(CharBuffer.wrap(text));
        System.out.println("bytes=" + bytes.remaining());
        String decoded = cs.newDecoder().decode(bytes).toString();
        System.out.println("roundTrip=" + text.equals(decoded));
    }
}

Résultat

bytes=5
roundTrip=true

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