CKTIS / Java
StandardCharsets — explicitní výběr kódování textu
StandardCharsets poskytuje hotové objekty Charset pro standardní kódování vyžadovaná platformou Java. Použijte StandardCharsets.UTF_8 nebo StandardCharsets.UTF_16BE a výslovně určete, jak se text převádí na bajty a bajty na text.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 obsahuje konstanty public static final typu Charset, nikoli názvy kódování typu String. Kódování převádí text na bajty; dekódování obnovuje text z bajtů. Každá implementace platformy Java zaručeně podporuje kódování reprezentovaná těmito konstantami.
StandardCharsets.UTF_8 vybírá UTF-8. StandardCharsets.UTF_16BE vybírá UTF-16, u kterého je nejvýznamnější bajt každé 16bitové jednotky první. Nezaměňujte UTF_16BE za UTF_16: při kódování UTF_16BE nepřidává značku pořadí bajtů (BOM), zatímco UTF_16 BOM přidává a používá pořadí big-endian. Při dekódování pomocí UTF_16BE zůstává počáteční BOM znakem U+FEFF, místo aby určovala pořadí bajtů.
Předejte konstantu výslovně metodám text.getBytes(StandardCharsets.UTF_8) a new String(bytes, StandardCharsets.UTF_8). Při čtení zvolte kódování odpovídající skutečnému formátu dat; konstanta ho nezjišťuje automaticky. Výslovná volba odstraňuje závislost tohoto převodu na výchozím kódování.
Příklad kóduje A\u0105 dvěma způsoby a vypisuje bajty v šestnáctkové soustavě. Očekávaný výstup je 41c485, 00410105, true, true, každé na samostatném řádku. Poslední dva řádky ověřují, že dekódování stejným kódováním obnoví text.
Příklady
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)));
}
}Výsledek
41c485 00410105 true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.