CKTIS / Java
Flussi di dati binari: leggere e scrivere byte, numeri e stringhe
Leggi i campi nello stesso ordine in cui li scrivi. Scopri come Java SE 21 rappresenta i numeri e perché il limite di `writeUTF` riguarda i byte codificati.
Versione: Java SE 21
Sintassi
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, DataOutputStream e DataInputStream, nel package java.io, incapsulano rispettivamente un flusso di uscita e uno di ingresso. Usa gli stessi tipi di campo nello stesso ordine sui due lati: il flusso non contiene marcatori di tipo o di versione. Leggere con un tipo o in un ordine diverso può produrre valori errati senza eccezioni.
writeByte(int) scrive solo gli otto bit meno significativi, senza controllare l’intervallo. readByte() restituisce un byte con segno da −128 a 127; per ottenere un int da 0 a 255, usa invece readUnsignedByte(). writeInt(int) e readInt() usano quattro byte per un int in ordine big-endian, con il byte più significativo per primo. writeDouble(double) e readDouble() usano otto byte nel formato IEEE 754 binary64, nello stesso ordine. In scrittura Double.doubleToLongBits usa una rappresentazione canonica per i NaN; in lettura si usa Double.longBitsToDouble.
writeUTF(String) scrive una lunghezza senza segno su due byte in ordine big-endian, seguita dai dati in UTF-8 modificato. Il limite di 65.535 riguarda i byte dei dati, prefisso escluso, non i caratteri o String.length(). Non è UTF-8 standard: U+0000 occupa due byte e un carattere fuori dal piano multilingue di base ne occupa sei, tre per unità di codice UTF-16. Il metodo di istanza readUTF() legge dal flusso incapsulato; l’overload statico DataInputStream.readUTF(DataInput) legge lo stesso formato dalla sorgente passata come argomento.
In scrittura, una stringa codificata troppo lunga causa UTFDataFormatException, mentre null causa NullPointerException. In lettura, una fine prematura durante un campo, il prefisso di lunghezza o i dati della stringa causa EOFException; una codifica non valida rilevata causa UTFDataFormatException. Entrambe sono sottotipi di IOException. Chiudere il flusso che incapsula l’altro chiude anche il flusso sottostante; usa try con risorse quando spetta a te chiuderlo.
Il formato non dipende dall’ordine dei byte della CPU né dal set di caratteri predefinito della piattaforma, ma un lettore non Java deve implementare lo stesso formato. Verifica i valori dei campi di record non fidati secondo le regole dell’applicazione: una decodifica riuscita non rende accettabili i valori.
Esempi
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));
}
}
}Risultato
ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9 -1 16909060 1.5 true
Il programma mostra i byte del record, poi i valori letti e il risultato del confronto tra stringhe. `ff` viene letto come `-1` con segno; `00 03` annuncia tre byte di dati anche se la stringa contiene due unità di codice UTF-16.
Lezioni correlate
- Java · Lezione 53 · Avanzato · Versione: 2