CKTIS / Java
Base64 — kódovanie a dekódovanie bajtov
Trieda java.util.Base64 predstavuje bajty ako text Base64 a dekódovaním ich obnovuje. Spoznajte variant Basic, výslovný prevod UTF-8 a spracovanie neplatných vstupných údajov.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);Base64 z balíka java.util poskytuje kódovače a dekódovače. Base64 je vratná textová reprezentácia bajtov, nie šifrovanie: nechráni dôvernosť. Tento záznam sa týka Java SE 21; produkčné runtime prostredie nebolo potvrdené.
Base64.getEncoder() vracia kódovač Basic. Base64.Encoder.encodeToString(byte[]) prevádza bajty na String. Base64.getDecoder() vracia dekódovač Basic a Base64.Decoder.decode(String) obnoví novo vytvorené pole byte[]. Pri texte výslovne použite StandardCharsets.UTF_8 pred kódovaním aj po dekódovaní; samotné Base64 neurčuje kódovanie znakov pôvodného textu.
Basic nepridáva zalomenia riadkov a jeho dekódovač odmieta znaky mimo svojej abecedy vrátane bielych znakov. Pre variant bezpečný pre URL použite getUrlEncoder() a getUrlDecoder(). MIME má samostatné továrenské metódy getMimeEncoder() a getMimeDecoder(); jeho dekódovač ignoruje znaky mimo abecedy. Vyberte variant podľa formátu údajov.
Neplatný vstup odovzdaný metóde decode(String) spôsobí IllegalArgumentException, zatiaľ čo null spôsobí NullPointerException. Záverečné doplnenie = možno vynechať, keď posledná skupina obsahuje dva alebo tri znaky Base64; ak doplnenie použijete, jeho počet musí byť správny. Príklad kontroluje obnovenie textu a zobrazuje očakávaný výstup.
Prí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ýsledok
SGVsbG8= Hello
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.