CKTIS / Java
Base64 — kodiranje i dekodiranje bajtova
Klasa java.util.Base64 prikazuje bajtove kao tekst Base64 i vraća ih dekodiranjem. Upoznajte varijantu Basic, izričitu pretvorbu u UTF-8 i obradu neispravnih ulaznih podataka.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
String encoded = Base64.getEncoder().encodeToString(bytes);
byte[] decoded = Base64.getDecoder().decode(encoded);Base64 iz paketa java.util pruža kodere i dekodere. Base64 je povratan tekstualni prikaz bajtova, a ne šifriranje: ne štiti povjerljivost. Ovaj se članak odnosi na Java SE 21; produkcijsko okruženje nije potvrđeno.
Base64.getEncoder() vraća koder Basic. Base64.Encoder.encodeToString(byte[]) pretvara bajtove u String. Base64.getDecoder() vraća dekoder Basic, a Base64.Decoder.decode(String) vraća novostvoreni byte[]. Za tekst izričito upotrijebite StandardCharsets.UTF_8 prije kodiranja i nakon dekodiranja; sam Base64 ne određuje kodiranje znakova izvornog teksta.
Basic ne dodaje prijelome redaka, a njegov dekoder odbacuje znakove izvan abecede, uključujući praznine. Za varijantu sigurnu za URL upotrijebite getUrlEncoder() i getUrlDecoder(). MIME ima zasebne tvorničke metode getMimeEncoder() i getMimeDecoder(); njegov dekoder zanemaruje znakove izvan abecede. Odaberite varijantu prema formatu podataka.
Neispravni ulazni podaci predani metodi decode(String) uzrokuju IllegalArgumentException, dok null uzrokuje NullPointerException. Završno dopunjavanje znakom = može se izostaviti kada posljednja skupina sadrži dva ili tri znaka Base64; ako je dopunjavanje prisutno, njegov broj mora biti ispravan. Primjer provjerava vraćanje teksta i prikazuje očekivani izlaz.
Primjeri
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);
}
}Rezultat
SGVsbG8= Hello
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.