Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

DataOutputStream — binarny zapis danych

DataOutputStream zapisuje wartości typów prostych i napisy do strumienia binarnego w określonym formacie. Poznaj rozmiary danych, kolejność bajtów oraz ograniczenia writeUTF.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

new 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

DataOutputStream z java.io opakowuje OutputStream i zapisuje dane binarne, a nie ich tekstową reprezentację. Odczyt przez DataInputStream musi odpowiadać kolejności i typom zapisanych wartości.

DataOutputStream.writeByte(int) zapisuje tylko 8 najmłodszych bitów: 257 daje bajt 0x01, bez sprawdzania zakresu. DataOutputStream.writeInt(int) zapisuje 4 bajty w kolejności big-endian, czyli od najbardziej znaczącego. DataOutputStream.writeDouble(double) zapisuje 8 bajtów w tej samej kolejności, po konwersji przez Double.doubleToLongBits.

DataOutputStream.writeUTF(String) zapisuje dwubajtową długość danych w bajtach, a następnie zmodyfikowany UTF-8. To nie jest zwykły UTF-8: znak NUL zajmuje 2 bajty, a znaki spoza BMP są kodowane jako pary surogatów. Limit wynosi 65535 bajtów zakodowanego tekstu, nie znaków; przekroczenie powoduje UTFDataFormatException.

Metody zapisu mogą zgłosić IOException. Współdzielenie strumienia między wątkami wymaga synchronizacji. Przykład pokazuje oczekiwane 17 bajtów jako zapis szesnastkowy. Zakres dokumentacji to Java SE 21; środowisko repozytorium ani środowisko produkcyjne nie zostały potwierdzone.

Przykłady

import java.io.ByteArrayOutputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.util.HexFormat;

public class Main {
    public static void main(String[] args) throws IOException {
        ByteArrayOutputStream bytes = new ByteArrayOutputStream();
        try (DataOutputStream out = new DataOutputStream(bytes)) {
            out.writeByte(257);
            out.writeInt(42);
            out.writeDouble(1.5);
            out.writeUTF("OK");
        }
        System.out.println(HexFormat.of().formatHex(bytes.toByteArray()));
    }
}

Wynik

010000002a3ff800000000000000024f4b

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła