CKTIS / Java
Binäre Datenströme: Bytes, Zahlen und Zeichenketten lesen und schreiben
Lies Felder in derselben Reihenfolge, in der du sie geschrieben hast. Erfahre, wie Java SE 21 Zahlen speichert und warum bei `writeUTF` die codierten Bytes zählen.
Version: 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 umschließen DataOutputStream und DataInputStream aus java.io einen Ausgabe- bzw. Eingabestrom. Lege auf beiden Seiten dieselben Feldtypen und dieselbe Reihenfolge fest: Der Datenstrom enthält keine Typ- oder Versionskennzeichen. Ein anderer Typ oder eine andere Reihenfolge kann falsche Werte liefern, ohne eine Ausnahme auszulösen.
writeByte(int) schreibt ohne Bereichsprüfung nur die acht niederwertigsten Bits. readByte() liefert einen vorzeichenbehafteten byte von −128 bis 127; für 0 bis 255 liefert readUnsignedByte() stattdessen einen int. writeInt(int) und readInt() verwenden vier Bytes pro int in Big-Endian-Reihenfolge, das höchstwertige Byte zuerst. writeDouble(double) und readDouble() verwenden acht Bytes im IEEE-754-Format binary64 in derselben Reihenfolge. Beim Schreiben vereinheitlicht Double.doubleToLongBits die NaN-Bitmuster; beim Lesen kommt Double.longBitsToDouble zum Einsatz.
writeUTF(String) schreibt eine vorzeichenlose Zwei-Byte-Länge in Big-Endian-Reihenfolge und danach modifiziertes UTF-8. Die Grenze von 65.535 gilt für Nutzdatenbytes ohne Längenpräfix, nicht für Zeichen oder String.length(). Anders als in Standard-UTF-8 belegt U+0000 zwei Bytes und ein Zeichen außerhalb der BMP sechs, je drei pro UTF-16-Codeeinheit. readUTF() liest aus dem umschlossenen Strom; die statische Überladung DataInputStream.readUTF(DataInput) liest dasselbe Format aus der übergebenen Quelle.
Beim Schreiben löst eine zu lange codierte Zeichenkette UTFDataFormatException aus, null hingegen NullPointerException. Beim Lesen führt ein vorzeitiges Ende innerhalb eines Felds, Längenpräfixes oder Textbereichs zu EOFException; erkannte Codierungsfehler führen zu UTFDataFormatException. Beide sind Untertypen von IOException. Das Schließen des Wrappers schließt den zugrunde liegenden Strom. Verwende try mit Ressourcen, wenn du für das Schließen verantwortlich bist.
Das Format hängt weder von der Byte-Reihenfolge der CPU noch von der Standardzeichencodierung der Plattform ab. Programme außerhalb von Java müssen aber dasselbe Format implementieren. Prüfe Feldwerte aus nicht vertrauenswürdigen Datensätzen nach den Regeln deiner Anwendung: Erfolgreiches Decodieren macht die Werte nicht automatisch zulässig.
Beispiele
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));
}
}
}Ergebnis
ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9 -1 16909060 1.5 true
Das Programm zeigt die Bytes des Datensatzes, dann die gelesenen Werte und das Ergebnis des Zeichenkettenvergleichs. `ff` ergibt vorzeichenbehaftet `-1`; `00 03` kündigt drei Nutzdatenbytes an, obwohl die Zeichenkette zwei UTF-16-Codeeinheiten hat.
Zugehörige Lektionen
- Java · Lektion 53 · Fortgeschritten · Version: 2