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.