CKTIS / Java
Base64 en Java : encoder et décoder des octets
Utilisez `java.util.Base64` pour représenter des octets sous forme de texte et les récupérer ensuite. Base64 est réversible et ne garantit ni la confidentialité ni l’intégrité.
Version : Java SE 21
Syntaxe
import java.util.Base64;
Base64.Encoder encoder = Base64.getEncoder();
Base64.Decoder decoder = Base64.getDecoder();
String encoded = encoder.encodeToString(bytes); // bytes: byte[]
byte[] decoded = decoder.decode(encoded);Dans Java SE 21, java.util.Base64 fournit deux méthodes statiques sans argument pour la variante Basic : Base64.getEncoder() renvoie un Base64.Encoder et Base64.getDecoder() renvoie un Base64.Decoder. Ces objets sont réutilisables et peuvent être partagés entre plusieurs threads. L’encodeur Basic n’insère pas de sauts de ligne. Si un protocole exige la variante adaptée aux URL ou la variante MIME, choisissez la paire de méthodes correspondante.
Base64.Encoder.encodeToString(byte[]) prend des octets et renvoie le texte Base64 sous forme de String ; encode(byte[]) renvoie plutôt les octets encodés. Base64.Decoder.decode(String) prend du texte Base64 et renvoie les octets d’origine dans un nouveau tableau. La surcharge decode(byte[]) prend des octets encodés au lieu de texte. Si les données d’origine sont du texte, convertissez-les en octets avec un jeu de caractères explicite, par exemple StandardCharsets.UTF_8. Après le décodage Base64, utilisez le même jeu de caractères pour reconstituer le texte.
L’encodeur Basic ajoute par défaut des caractères de remplissage = à la fin si nécessaire. Le décodeur accepte leur absence si le dernier groupe contient deux ou trois caractères Base64. Le décodeur Basic rejette les caractères hors de l’alphabet autorisé, y compris les caractères d’espacement, ainsi que le remplissage incorrect. Dans ces cas, decode(String) lève une IllegalArgumentException. Un argument null provoque une NullPointerException.
Base64 représente des octets sous forme de texte de manière réversible : ce n’est ni un chiffrement ni un contrôle d’intégrité. N’importe qui peut décoder les données, et un décodage réussi ne prouve pas qu’elles sont restées intactes.
Exemples
import java.nio.charset.StandardCharsets;
import java.util.Arrays;
import java.util.Base64;
public class Base64RoundTrip {
public static void main(String[] args) {
byte[] original = "caf\u00E9".getBytes(StandardCharsets.UTF_8);
Base64.Encoder encoder = Base64.getEncoder();
Base64.Decoder decoder = Base64.getDecoder();
String encoded = encoder.encodeToString(original);
byte[] decoded = decoder.decode(encoded);
System.out.println(encoded);
System.out.println(Arrays.equals(original, decoded));
}
}Résultat
Y2Fmw6k= true
Le texte `café` est converti en octets UTF-8, encodé en `Y2Fmw6k=`, puis décodé. `true` indique que les deux tableaux d’octets ont le même contenu.
Leçons associées
- Java · Leçon 51 · Avancé · Version : 2