CKTIS / Java
Flux de données binaires : lire et écrire des octets, des nombres et des chaînes
Relisez les champs dans leur ordre d’écriture. Voyez comment Java SE 21 représente les nombres et pourquoi la limite de `writeUTF` se mesure en octets encodés.
Version : Java SE 21
Syntaxe
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 IOExceptionDans Java SE 21, DataOutputStream et DataInputStream, du paquet java.io, enveloppent respectivement un flux de sortie et un flux d’entrée. Convenez des mêmes types et du même ordre des champs des deux côtés : le flux ne contient aucune balise de type ou de version. Lire un autre type ou dans un autre ordre peut donner des valeurs erronées sans exception.
writeByte(int) écrit uniquement les huit bits de poids faible, sans vérifier la plage. readByte() renvoie un byte signé de −128 à 127 ; pour obtenir un int de 0 à 255, utilisez plutôt readUnsignedByte(). writeInt(int) et readInt() utilisent quatre octets par int, en ordre gros-boutiste (octet de poids fort en premier). writeDouble(double) et readDouble() utilisent huit octets au format IEEE 754 binary64, dans le même ordre. À l’écriture, Double.doubleToLongBits ramène les NaN à une forme canonique ; la lecture utilise Double.longBitsToDouble.
writeUTF(String) écrit une longueur non signée sur deux octets en ordre gros-boutiste, puis les données en UTF-8 modifié. La limite de 65 535 concerne les octets de données hors préfixe, et non les caractères ou String.length(). Contrairement à l’UTF-8 standard, U+0000 occupe deux octets et un caractère hors du plan multilingue de base en occupe six, trois par unité de code UTF-16. La méthode d’instance readUTF() lit le flux enveloppé ; la surcharge statique DataInputStream.readUTF(DataInput) lit le même format depuis la source fournie.
À l’écriture, une chaîne encodée trop longue provoque UTFDataFormatException, et null provoque NullPointerException. À la lecture, une fin prématurée dans un champ, le préfixe de longueur ou les données de la chaîne provoque EOFException ; un encodage mal formé détecté provoque UTFDataFormatException. Ces deux exceptions dérivent d’IOException. Fermer le flux enveloppant ferme le flux sous-jacent ; utilisez try avec ressources si vous êtes responsable de sa fermeture.
Le format ne dépend ni de l’ordre des octets du processeur ni du jeu de caractères par défaut de la plateforme, mais un lecteur hors Java doit implémenter le même format. Contrôlez les valeurs issues d’enregistrements non fiables selon les règles de votre application : un décodage réussi ne suffit pas à les rendre acceptables.
Exemples
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));
}
}
}Résultat
ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9 -1 16909060 1.5 true
Le programme affiche les octets de l’enregistrement, puis les valeurs lues et le résultat de la comparaison des chaînes. `ff` est lu comme `-1` signé ; `00 03` annonce trois octets de données alors que la chaîne compte deux unités de code UTF-16.
Leçons associées
- Java · Leçon 53 · Avancé · Version : 2