Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Base64 w Javie: kodowanie i dekodowanie bajtów

Użyj `java.util.Base64`, aby odwracalnie zamieniać bajty na tekst i odzyskiwać je z tego tekstu. Base64 nie zapewnia poufności ani integralności.

Wersja: Java SE 21

Składnia

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

W Java SE 21 klasa java.util.Base64 udostępnia dwie statyczne metody bez argumentów dla wariantu Basic: Base64.getEncoder() zwraca Base64.Encoder, a Base64.getDecoder() zwraca Base64.Decoder. Można ich używać wielokrotnie i współdzielić między wątkami. Enkoder Basic nie wstawia znaków końca wiersza. Jeśli protokół wymaga wariantu URL-safe lub MIME, wybierz odpowiednią parę metod zamiast Basic.

Base64.Encoder.encodeToString(byte[]) przyjmuje bajty i zwraca tekst Base64 jako String; encode(byte[]) zwraca zakodowane bajty. Base64.Decoder.decode(String) przyjmuje tekst Base64 i zwraca oryginalne bajty w nowej tablicy. Przeciążenie decode(byte[]) zamiast tekstu przyjmuje zakodowane bajty. Jeśli dane źródłowe są tekstem, przekształć je w bajty za pomocą jawnie wybranego kodowania znaków, np. StandardCharsets.UTF_8. Po dekodowaniu Base64 użyj tego samego kodowania znaków, aby odtworzyć tekst.

Enkoder Basic domyślnie dodaje końcowe wypełnienie =, gdy jest potrzebne. Dekoder akceptuje jego brak, jeśli ostatnia grupa zawiera dwa lub trzy znaki Base64. Dekoder Basic odrzuca znaki spoza dozwolonego alfabetu, w tym białe znaki, oraz nieprawidłowe wypełnienie; decode(String) zgłasza wtedy IllegalArgumentException. Argument null powoduje NullPointerException.

Base64 to odwracalna reprezentacja bajtów w postaci tekstu, a nie szyfrowanie ani mechanizm ochrony integralności. Każdy może odczytać zakodowane dane, a pomyślne dekodowanie nie dowodzi, że nikt ich nie zmienił.

Przykłady

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

Wynik

Y2Fmw6k=
true

Tekst `café` zostaje przekształcony w bajty UTF-8, zakodowany jako `Y2Fmw6k=` i zdekodowany. `true` oznacza, że zawartość obu tablic bajtów jest taka sama.

Powiązane lekcje

  • Java · Lekcja 51 · Zaawansowany · Wersja: 2

Źródła