Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Binarne strumienie danych: zapis i odczyt bajtów, liczb i tekstu

Zapisuj i odczytuj pola rekordu w tej samej kolejności. Sprawdź, jak Java SE 21 zapisuje liczby i dlaczego limit `writeUTF` dotyczy bajtów po zakodowaniu.

Wersja: Java SE 21

Składnia

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 IOException

W Java SE 21 klasy DataOutputStream i DataInputStream z pakietu java.io opakowują odpowiednio strumień wyjściowy i wejściowy. Ustal typy i kolejność pól po obu stronach: strumień nie zawiera znaczników typów ani wersji. Zmiana kolejności lub typu pola może dać błędne wartości bez wyjątku.

writeByte(int) zapisuje tylko osiem najmniej znaczących bitów, bez sprawdzania zakresu. readByte() zwraca byte ze znakiem od −128 do 127; dla wartości 0–255 użyj zamiast niego readUnsignedByte(), które zwraca int. writeInt(int) i readInt() zapisują i odczytują czterobajtowy int w kolejności big-endian, od najbardziej znaczącego bajtu. writeDouble(double) i readDouble() używają ośmiu bajtów IEEE 754 binary64 w tej samej kolejności. Zapis korzysta z Double.doubleToLongBits, które sprowadza NaN do postaci kanonicznej; odczyt używa Double.longBitsToDouble.

writeUTF(String) zapisuje dwubajtową długość bez znaku w kolejności big-endian, po której następują dane w zmodyfikowanym UTF-8. Limit 65 535 dotyczy bajtów danych, bez prefiksu, a nie znaków ani wyniku String.length(). To nie jest standardowe UTF-8: U+0000 zajmuje dwa bajty, a znak spoza BMP jest kodowany jako dwie jednostki UTF-16 po trzy bajty każda. Metoda instancyjna readUTF() czyta z opakowanego strumienia; statyczne przeciążenie DataInputStream.readUTF(DataInput) czyta ten sam format z przekazanego źródła.

Zbyt długi zakodowany tekst powoduje UTFDataFormatException przy zapisie, a null powoduje NullPointerException. Przy odczycie przedwczesny koniec pola, prefiksu lub danych tekstowych powoduje EOFException, a wykryte nieprawidłowe kodowanie powoduje UTFDataFormatException. Oba wyjątki są podtypami IOException. Zamknięcie strumienia opakowującego zamyka strumień bazowy; użyj try z zasobami, jeśli odpowiadasz za jego zamknięcie.

Format nie zależy od kolejności bajtów procesora ani domyślnego kodowania platformy, ale odbiorca spoza Javy musi zaimplementować ten sam format. Po odczycie niezaufanego rekordu sprawdź wartości zgodnie z regułami aplikacji; poprawne zdekodowanie nie oznacza, że wartości są dopuszczalne.

Przykłady

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));
        }
    }
}

Wynik

ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9
-1
16909060
1.5
true

Program najpierw pokazuje bajty rekordu, a potem odczytane wartości i wynik porównania tekstu. Bajt `ff` daje `-1` przy odczycie ze znakiem, a `00 03` zapowiada trzy bajty tekstu, choć napis ma dwie jednostki UTF-16.

Powiązane lekcje

  • Java · Lekcja 53 · Zaawansowany · Wersja: 2

Źródła