CKTIS / Java
Base64 v Javě: kódování a dekódování bajtů
Pomocí `java.util.Base64` vyjádříš bajty jako text a získáš z něj původní bajty. Base64 je vratné kódování a nezajišťuje důvěrnost ani integritu.
Verze: 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);V Java SE 21 nabízí java.util.Base64 dvě statické metody bez argumentů pro variantu Basic: Base64.getEncoder() vrací Base64.Encoder a Base64.getDecoder() vrací Base64.Decoder. Tyto objekty lze používat opakovaně a sdílet mezi vlákny. Kodér Basic nevkládá konce řádků. Pokud protokol vyžaduje variantu bezpečnou pro URL nebo variantu MIME, zvol odpovídající dvojici metod.
Base64.Encoder.encodeToString(byte[]) přijímá bajty a vrací text Base64 jako String; encode(byte[]) vrací zakódované bajty. Base64.Decoder.decode(String) přijímá text Base64 a vrací původní bajty v novém poli. Přetížená metoda decode(byte[]) přijímá namísto textu zakódované bajty. Pokud jsou zdrojová data text, převeď je na bajty s výslovně zvolenou znakovou sadou, například StandardCharsets.UTF_8. Po dekódování Base64 použij stejnou znakovou sadu k obnovení textu.
Kodér Basic ve výchozím nastavení podle potřeby doplní na konec výplňové znaky =. Dekodér přijímá i vstup bez výplně, pokud poslední skupina obsahuje dva nebo tři znaky Base64. Dekodér Basic odmítá znaky mimo povolenou abecedu včetně bílých znaků i chybně zapsanou výplň. V těchto případech decode(String) vyvolá IllegalArgumentException. Argument null způsobí NullPointerException.
Base64 je vratný způsob zápisu bajtů jako textu, nikoli šifrování ani kontrola integrity. Data může dekódovat kdokoli a úspěšné dekódování nedokazuje, že zůstala beze změny.
Příklady
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));
}
}Výsledek
Y2Fmw6k= true
Text `café` se převede na bajty UTF-8, zakóduje jako `Y2Fmw6k=` a dekóduje. `true` znamená, že obě bajtová pole mají stejný obsah.
Související lekce
- Java · Lekce 51 · Pokročilá · Verze: 2