Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

DataOutputStream — scrivere dati binari

DataOutputStream scrive valori primitivi e stringhe in un flusso binario secondo un formato definito. Scopri le dimensioni dei dati, l’ordine dei byte e i limiti di writeUTF.

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

Sintassi

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 di java.io avvolge un OutputStream e scrive dati binari anziché rappresentazioni testuali. La lettura con DataInputStream deve rispettare l’ordine e i tipi dei valori scritti.

DataOutputStream.writeByte(int) scrive solo gli 8 bit meno significativi: 257 produce il byte 0x01, senza controllare l’intervallo. DataOutputStream.writeInt(int) scrive 4 byte in ordine big-endian, a partire dal più significativo. DataOutputStream.writeDouble(double) scrive 8 byte nello stesso ordine, dopo la conversione tramite Double.doubleToLongBits.

DataOutputStream.writeUTF(String) scrive una lunghezza dei dati di due byte, espressa in byte, seguita da UTF-8 modificato. Non è UTF-8 ordinario: NUL occupa 2 byte e i caratteri al di fuori del piano multilingue di base vengono codificati come coppie di surrogati. Il limite è di 65535 byte di dati codificati, non di caratteri; superarlo causa UTFDataFormatException.

I metodi di scrittura possono generare IOException. La condivisione del flusso tra più thread richiede la sincronizzazione. L’esempio mostra i 17 byte attesi in formato esadecimale. La documentazione riguarda Java SE 21; non è stato attestato né l’ambiente di esecuzione del repository né quello di produzione.

Esempi

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

Risultato

010000002a3ff800000000000000024f4b

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti