Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Base64 — kódování a dekódování bajtů

Třída java.util.Base64 převádí bajty na text Base64 a dekódováním je obnovuje. Seznamte se se základní variantou Basic, výslovným převodem UTF-8 a zpracováním neplatných vstupních dat.

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

Syntaxe

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

Base64 z balíčku java.util poskytuje kodéry a dekodéry. Base64 je vratná textová reprezentace bajtů, nikoli šifrování: nechrání důvěrnost. Tento záznam se vztahuje k Java SE 21; produkční běhové prostředí nebylo potvrzeno.

Base64.getEncoder() vrací kodér Basic. Base64.Encoder.encodeToString(byte[]) převádí bajty na String. Base64.getDecoder() vrací dekodér Basic a Base64.Decoder.decode(String) obnoví nově vytvořené pole byte[]. U textu výslovně použijte StandardCharsets.UTF_8 před kódováním i po dekódování; samotné Base64 neurčuje kódování znaků původního textu.

Basic nepřidává zalomení řádků a jeho dekodér odmítá znaky mimo svou abecedu, včetně bílých znaků. Pro variantu bezpečnou pro URL použijte getUrlEncoder() a getUrlDecoder(). MIME má samostatné tovární metody getMimeEncoder() a getMimeDecoder(); jeho dekodér ignoruje znaky mimo abecedu. Zvolte variantu podle formátu dat.

Neplatný vstup předaný metodě decode(String) způsobí IllegalArgumentException, zatímco null způsobí NullPointerException. Závěrečné doplnění = lze vynechat, pokud poslední skupina obsahuje dva nebo tři znaky Base64; pokud doplnění použijete, jeho počet musí být správný. Příklad ověřuje obnovení textu a ukazuje očekávaný výstup.

Příklady

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);
    }
}

Výsledek

SGVsbG8=
Hello

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje