CKTIS / Java
Binárne dátové prúdy: čítanie a zápis bajtov, čísel a reťazcov
Čítaj polia v rovnakom poradí, v akom ich zapisuješ. Zisti, ako Java SE 21 ukladá čísla a prečo sa limit `writeUTF` vzťahuje na bajty po zakódovaní.
Verzia: Java SE 21
Syntax
Java SE 21 · java.io
DataOutputStream(OutputStream out)
void writeByte(int v) throws IOException
void writeInt(int v) throws IOException
void writeDouble(double v) throws IOException
void writeUTF(String str) throws IOException
DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOException
static String readUTF(DataInput in) throws IOExceptionV Java SE 21 triedy DataOutputStream a DataInputStream z balíka java.io obaľujú výstupný, respektíve vstupný prúd. Na oboch stranách dodrž rovnaké typy polí a ich poradie: prúd neobsahuje značky typu ani verzie. Čítanie iného typu alebo v inom poradí môže vrátiť nesprávne hodnoty bez výnimky.
writeByte(int) zapíše len osem najmenej významných bitov a nekontroluje rozsah. readByte() vráti byte so znamienkom od −128 do 127; ak chceš int od 0 do 255, použi readUnsignedByte(). writeInt(int) a readInt() používajú štyri bajty na int v poradí big-endian, od najvýznamnejšieho bajtu. writeDouble(double) a readDouble() používajú osem bajtov vo formáte IEEE 754 binary64 v rovnakom poradí. Pri zápise Double.doubleToLongBits prevádza NaN na kanonickú reprezentáciu; pri čítaní sa používa Double.longBitsToDouble.
writeUTF(String) zapíše dvojbajtovú dĺžku bez znamienka v poradí big-endian a za ňou dáta v modifikovanom UTF-8. Limit 65 535 platí pre dátové bajty bez predpony, nie pre znaky ani pre String.length(). Nie je to štandardné UTF-8: U+0000 zaberá dva bajty a znak mimo základnej viacjazyčnej roviny šesť, tri na každú kódovú jednotku UTF-16. Inštančná metóda readUTF() číta z obaleného prúdu; statické preťaženie DataInputStream.readUTF(DataInput) číta rovnaký formát z odovzdaného zdroja.
Pri zápise príliš dlhého zakódovaného reťazca vznikne UTFDataFormatException, pri odovzdaní null vznikne NullPointerException. Pri čítaní predčasný koniec vnútri poľa, predpony dĺžky alebo dát reťazca vyvolá EOFException; zistené chybné kódovanie vyvolá UTFDataFormatException. Obe sú podtypmi IOException. Zatvorením obalu sa zatvorí aj podkladový prúd; použi try so zdrojmi, ak za jeho zatvorenie zodpovedáš.
Formát nezávisí od poradia bajtov procesora ani od predvoleného kódovania platformy, ale čítačka mimo Javy musí implementovať rovnaký formát. Podľa pravidiel aplikácie over hodnoty polí z nedôveryhodných záznamov: úspešné dekódovanie ešte neznamená, že sú hodnoty prípustné.
Príklady
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.util.HexFormat;
public class DataStreamDemo {
public static void main(String[] args) throws IOException {
String label = "A\u00E9";
ByteArrayOutputStream buffer = new ByteArrayOutputStream();
try (var out = new DataOutputStream(buffer)) {
out.writeByte(255);
out.writeInt(0x01020304);
out.writeDouble(1.5);
out.writeUTF(label);
}
byte[] record = buffer.toByteArray();
System.out.println(HexFormat.ofDelimiter(" ").formatHex(record));
try (var in = new DataInputStream(new ByteArrayInputStream(record))) {
System.out.println(in.readByte());
System.out.println(in.readInt());
System.out.println(in.readDouble());
System.out.println(in.readUTF().equals(label));
}
}
}Výsledok
ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9 -1 16909060 1.5 true
Program vypíše bajty záznamu, načítané hodnoty a výsledok porovnania reťazcov. `ff` sa so znamienkom načíta ako `-1`; `00 03` oznamuje tri dátové bajty, hoci má reťazec dve kódové jednotky UTF-16.
Súvisiace lekcie
- Java · Lekcia 53 · Pokročilá · Verzia: 2