CKTIS / Java
Flujos de datos binarios: leer y escribir bytes, números y cadenas
Lee los campos en el mismo orden en que los escribiste. Descubre cómo representa los números Java SE 21 y por qué `writeUTF` limita los bytes codificados.
Versión: Java SE 21
Sintaxis
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 IOExceptionEn Java SE 21, DataOutputStream y DataInputStream, del paquete java.io, envuelven un flujo de salida y uno de entrada, respectivamente. Acuerda los mismos tipos y el mismo orden de campos en ambos extremos: el flujo no incluye etiquetas de tipo ni de versión. Leer con otro tipo o en otro orden puede devolver valores incorrectos sin lanzar una excepción.
writeByte(int) escribe solo los ocho bits menos significativos, sin comprobar el rango. readByte() devuelve un byte con signo de −128 a 127; para obtener un int de 0 a 255, usa readUnsignedByte(). writeInt(int) y readInt() utilizan cuatro bytes por int en orden big-endian, con el byte más significativo primero. writeDouble(double) y readDouble() utilizan ocho bytes en formato IEEE 754 binary64 en el mismo orden. La escritura usa Double.doubleToLongBits, que convierte los NaN a una representación canónica; la lectura usa Double.longBitsToDouble.
writeUTF(String) escribe una longitud sin signo de dos bytes en orden big-endian, seguida de los datos en UTF-8 modificado. El límite de 65 535 se aplica a los bytes de datos, sin contar el prefijo, no a los caracteres ni a String.length(). No es UTF-8 estándar: U+0000 ocupa dos bytes y un carácter fuera del plano multilingüe básico ocupa seis, tres por unidad de código UTF-16. El método de instancia readUTF() lee del flujo envuelto; la sobrecarga estática DataInputStream.readUTF(DataInput) lee el mismo formato de la fuente proporcionada.
Al escribir, una cadena codificada demasiado larga provoca UTFDataFormatException, y null provoca NullPointerException. Al leer, un fin prematuro dentro de un campo, del prefijo de longitud o de los datos de la cadena provoca EOFException; si se detecta una codificación incorrecta, se lanza UTFDataFormatException. Ambas son subtipos de IOException. Cerrar el envoltorio cierra el flujo subyacente; usa try con recursos cuando seas responsable de cerrarlo.
El formato no depende del orden de bytes de la CPU ni de la codificación predeterminada de la plataforma, pero un lector ajeno a Java debe implementar el mismo formato. Valida los valores de registros no confiables según las reglas de tu aplicación: que se puedan decodificar no significa que sean aceptables.
Ejemplos
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));
}
}
}Resultado
ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9 -1 16909060 1.5 true
El programa muestra los bytes del registro, los valores leídos y el resultado de comparar las cadenas. `ff` se lee como `-1` con signo, y `00 03` anuncia tres bytes de datos aunque la cadena tiene dos unidades de código UTF-16.
Lecciones relacionadas
- Java · Lección 53 · Avanzado · Versión: 2