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

CKTIS / Java

Base64 — encoder et décoder des octets

La classe java.util.Base64 représente des octets sous forme de texte Base64 et les restitue par décodage. Découvrez la variante Basic, la conversion explicite en UTF-8 et la gestion des entrées mal formées.

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

Syntaxe

String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);

Base64 dans java.util fournit des encodeurs et des décodeurs. Base64 est une représentation textuelle réversible d’octets, et non un chiffrement : elle ne protège pas la confidentialité. Cette fiche concerne Java SE 21 ; l’environnement d’exécution de production n’a pas été attesté.

Base64.getEncoder() renvoie un encodeur Basic. Base64.Encoder.encodeToString(byte[]) convertit des octets en String. Base64.getDecoder() renvoie un décodeur Basic, et Base64.Decoder.decode(String) restitue un nouveau byte[] alloué. Pour du texte, utilisez explicitement StandardCharsets.UTF_8 avant l’encodage et après le décodage ; Base64 ne définit pas à elle seule l’encodage des caractères du texte d’origine.

Basic n’ajoute pas de sauts de ligne, et son décodeur rejette les caractères hors de son alphabet, y compris les espaces. Utilisez getUrlEncoder() et getUrlDecoder() pour la variante adaptée aux URL. MIME dispose de fabriques distinctes, getMimeEncoder() et getMimeDecoder() ; son décodeur ignore les caractères hors de l’alphabet. Choisissez la variante adaptée au format des données.

Une entrée mal formée transmise à decode(String) provoque IllegalArgumentException, tandis que null provoque NullPointerException. Le remplissage final = peut être omis lorsque le dernier groupe contient deux ou trois caractères Base64 ; s’il est présent, son nombre doit être correct. L’exemple vérifie la restitution du texte et présente la sortie attendue.

Exemples

import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class Main {
    public static void main(String[] args) {
        String original = "Hello";
        byte[] bytes = original.getBytes(StandardCharsets.UTF_8);
        String encoded = Base64.getEncoder().encodeToString(bytes);
        byte[] decoded = Base64.getDecoder().decode(encoded);
        String restored = new String(decoded, StandardCharsets.UTF_8);

        if (!original.equals(restored)) {
            throw new AssertionError("Round-trip failed");
        }
        System.out.println(encoded);
        System.out.println(restored);
    }
}

Résultat

SGVsbG8=
Hello

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