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.