CKTIS / Java
StandardCharsets — výslovný výber kódovania textu
StandardCharsets poskytuje hotové objekty Charset pre štandardné kódovania vyžadované platformou Java. Použite StandardCharsets.UTF_8 alebo StandardCharsets.UTF_16BE a výslovne určite, ako sa text mení na bajty a bajty na text.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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 konštanty public static final typu Charset, nie názvy kódovania typu String. Kódovanie prevádza text na bajty; dekódovanie obnovuje text z bajtov. Každá implementácia platformy Java zaručene podporuje kódovania reprezentované týmito konštantami.
StandardCharsets.UTF_8 vyberá UTF-8. StandardCharsets.UTF_16BE vyberá UTF-16, pri ktorom je najvýznamnejší bajt každej 16-bitovej jednotky prvý. Nezamieňajte UTF_16BE s UTF_16: pri kódovaní UTF_16BE nepridáva značku poradia bajtov (BOM), zatiaľ čo UTF_16 BOM pridáva a používa poradie big-endian. Pri dekódovaní pomocou UTF_16BE zostáva úvodná BOM znakom U+FEFF namiesto toho, aby určovala poradie bajtov.
Konštantu výslovne odovzdajte metódam text.getBytes(StandardCharsets.UTF_8) a new String(bytes, StandardCharsets.UTF_8). Pri čítaní vyberte kódovanie zodpovedajúce skutočnému formátu údajov; konštanta ho nezistí automaticky. Výslovný výber odstraňuje závislosť tohto prevodu od predvoleného kódovania.
Príklad kóduje A\u0105 dvoma spôsobmi a vypisuje bajty v šestnástkovej sústave. Očakávaný výstup je 41c485, 00410105, true, true, každý na samostatnom riadku. Posledné dva riadky overujú, že dekódovanie rovnakým kódovaním obnoví text.
Prí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ýsledok
41c485 00410105 true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.