Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

StandardCharsets — jawny wybór kodowania tekstu

StandardCharsets udostępnia gotowe obiekty Charset dla standardowych kodowań wymaganych przez platformę Java. Używaj StandardCharsets.UTF_8 lub StandardCharsets.UTF_16BE, aby jawnie określać sposób zamiany tekstu na bajty i bajtów na tekst.

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

Składnia

import java.nio.charset.StandardCharsets;
byte[] bytes = text.getBytes(StandardCharsets.UTF_8);
String restored = new String(bytes, StandardCharsets.UTF_8);
byte[] bigEndian = text.getBytes(StandardCharsets.UTF_16BE);

java.nio.charset.StandardCharsets zawiera stałe public static final typu Charset, a nie nazwy kodowań typu String. Kodowanie zamienia tekst na bajty, a dekodowanie odtwarza tekst z bajtów. Obsługa kodowań wskazywanych przez te stałe jest gwarantowana w każdej implementacji platformy Java.

StandardCharsets.UTF_8 wybiera UTF-8. StandardCharsets.UTF_16BE wybiera UTF-16 z bardziej znaczącym bajtem każdej 16-bitowej jednostki na początku. Nie należy mylić UTF_16BE z UTF_16: podczas kodowania UTF_16BE nie dodaje znacznika kolejności bajtów (BOM), natomiast UTF_16 dodaje BOM i używa kolejności big-endian. Przy dekodowaniu UTF_16BE początkowy BOM pozostaje znakiem U+FEFF, zamiast sterować kolejnością bajtów.

Przekazuj stałą jawnie do text.getBytes(StandardCharsets.UTF_8) i new String(bytes, StandardCharsets.UTF_8). Przy odczycie wybierz kodowanie zgodne z faktycznym formatem danych; stała nie wykrywa go automatycznie. Jawny wybór usuwa zależność tej konwersji od kodowania domyślnego.

Przykład koduje A\u0105 na dwa sposoby i wypisuje bajty szesnastkowo. Oczekiwany wynik to 41c485, 00410105, true, true, każde w osobnym wierszu. Dwa ostatnie wiersze sprawdzają odtworzenie tekstu przy użyciu tego samego kodowania.

Przykłady

import java.nio.charset.StandardCharsets;
import java.util.HexFormat;

public class Main {
    public static void main(String[] args) {
        String text = "A\u0105";
        byte[] utf8 = text.getBytes(StandardCharsets.UTF_8);
        byte[] utf16be = text.getBytes(StandardCharsets.UTF_16BE);

        System.out.println(HexFormat.of().formatHex(utf8));
        System.out.println(HexFormat.of().formatHex(utf16be));
        System.out.println(text.equals(new String(utf8, StandardCharsets.UTF_8)));
        System.out.println(text.equals(new String(utf16be, StandardCharsets.UTF_16BE)));
    }
}

Wynik

41c485
00410105
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła