CKTIS / Java
Binární datové proudy: čtení a zápis bajtů, čísel a řetězců
Čti pole ve stejném pořadí, v jakém je zapisuješ. Zjisti, jak Java SE 21 ukládá čísla a proč limit `writeUTF` počítá bajty po zakódování.
Verze: Java SE 21
Syntaxe
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 třídy DataOutputStream a DataInputStream z balíčku java.io obalují výstupní, respektive vstupní proud. Na obou stranách dodržuj stejné typy polí a jejich pořadí: proud neobsahuje značky typů ani verze. Čtení jiného typu nebo v jiném pořadí může vrátit nesprávné hodnoty bez výjimky.
writeByte(int) zapisuje jen osm nejméně významných bitů a nekontroluje rozsah. readByte() vrací byte se znaménkem od −128 do 127; pro int od 0 do 255 použij readUnsignedByte(). writeInt(int) a readInt() používají čtyři bajty na int v pořadí big-endian, tedy od nejvýznamnějšího bajtu. writeDouble(double) a readDouble() používají osm bajtů ve formátu IEEE 754 binary64 ve stejném pořadí. Při zápisu Double.doubleToLongBits převádí NaN na kanonickou reprezentaci; při čtení se používá Double.longBitsToDouble.
writeUTF(String) zapisuje dvoubajtovou délku bez znaménka v pořadí big-endian a za ní data v modifikovaném UTF-8. Limit 65 535 platí pro datové bajty bez předpony, ne pro znaky ani pro String.length(). Nejde o standardní UTF-8: U+0000 zabírá dva bajty a znak mimo základní vícejazyčnou rovinu šest, tři na každou kódovou jednotku UTF-16. Instanční metoda readUTF() čte z obaleného proudu; statické přetížení DataInputStream.readUTF(DataInput) čte stejný formát z předaného zdroje.
Při zápisu příliš dlouhého zakódovaného řetězce vznikne UTFDataFormatException, při předání null vznikne NullPointerException. Předčasný konec při čtení pole, předpony délky nebo dat řetězce vyvolá EOFException; zjištěná chyba kódování vyvolá UTFDataFormatException. Obě jsou podtypy IOException. Zavřením obalu se zavře i podkladový proud; použij try se zdroji, pokud za jeho zavření odpovídáš.
Formát nezávisí na pořadí bajtů procesoru ani na výchozím kódování platformy, ale čtečka mimo Javu musí implementovat stejný formát. Hodnoty polí z nedůvěryhodných záznamů ověř podle pravidel aplikace: úspěšné dekódování ještě neznamená, že jsou hodnoty přípustné.
Pří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ýsledek
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čtené hodnoty a výsledek porovnání řetězců. `ff` se znaménkem dává `-1`; `00 03` ohlašuje tři datové bajty, přestože má řetězec dvě kódové jednotky UTF-16.
Související lekce
- Java · Lekce 53 · Pokročilá · Verze: 2