CKTIS / Java
Binaire gegevensstromen: bytes, getallen en tekenreeksen lezen en schrijven
Lees velden in dezelfde volgorde als waarin je ze schreef. Zie hoe Java SE 21 getallen opslaat en waarom voor de limiet van `writeUTF` de gecodeerde bytes tellen.
Versie: 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 IOExceptionIn Java SE 21 verpakken DataOutputStream en DataInputStream uit java.io respectievelijk een uitvoer- en een invoerstroom. Spreek aan beide kanten dezelfde veldtypen en volgorde af: de stroom bevat geen type- of versiemarkeringen. Met een ander type of een andere volgorde kun je verkeerde waarden krijgen zonder uitzondering.
writeByte(int) schrijft alleen de acht minst significante bits, zonder bereikcontrole. readByte() geeft een byte met teken van −128 tot 127 terug; gebruik readUnsignedByte() voor een int van 0 tot 255. writeInt(int) en readInt() gebruiken vier bytes per int in big-endianvolgorde, met de meest significante byte eerst. writeDouble(double) en readDouble() gebruiken acht bytes in het IEEE 754 binary64-formaat, in dezelfde volgorde. Bij schrijven brengt Double.doubleToLongBits NaN-waarden terug tot één canonieke representatie; bij lezen wordt Double.longBitsToDouble gebruikt.
writeUTF(String) schrijft een lengte zonder teken van twee bytes in big-endianvolgorde, gevolgd door de gegevens in aangepast UTF-8. De grens van 65.535 geldt voor gegevensbytes zonder lengtevoorvoegsel, niet voor tekens of String.length(). Het is geen standaard-UTF-8: U+0000 neemt twee bytes in en een teken buiten het basisvlak neemt zes bytes in, drie per UTF-16-code-eenheid. De instantiemethode readUTF() leest uit de verpakte stroom; de statische overload DataInputStream.readUTF(DataInput) leest hetzelfde formaat uit de opgegeven bron.
Bij schrijven leidt een te lange gecodeerde tekenreeks tot UTFDataFormatException, en null tot NullPointerException. Bij lezen leidt een voortijdig einde binnen een veld, het lengtevoorvoegsel of de tekstgegevens tot EOFException; een geconstateerde coderingsfout leidt tot UTFDataFormatException. Beide zijn subtypen van IOException. Als je de wrapper sluit, sluit je ook de onderliggende stroom. Gebruik try met resources als jij verantwoordelijk bent voor het sluiten.
Het formaat hangt niet af van de bytevolgorde van de processor of de standaardtekencodering van het platform. Een lezer buiten Java moet wel hetzelfde formaat implementeren. Controleer veldwaarden uit onbetrouwbare records volgens de regels van je toepassing: geslaagde decodering maakt de waarden nog niet geldig.
Voorbeelden
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));
}
}
}Resultaat
ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9 -1 16909060 1.5 true
Het programma toont de bytes van het record, daarna de gelezen waarden en het resultaat van de tekenreeksvergelijking. `ff` wordt gelezen als `-1` met teken; `00 03` kondigt drie gegevensbytes aan, hoewel de tekenreeks twee UTF-16-code-eenheden telt.
Gerelateerde lessen
- Java · Les 53 · Gevorderd · Versie: 2