Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Fluxos de dados binários: ler e escrever bytes, números e cadeias de texto

Lê os campos na mesma ordem em que os escreves. Vê como Java SE 21 representa os números e porque é que o limite de `writeUTF` se mede em bytes codificados.

Versão: Java SE 21

Sintaxe

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 IOException

Em Java SE 21, DataOutputStream e DataInputStream, do pacote java.io, encapsulam, respetivamente, um fluxo de saída e um de entrada. Usa os mesmos tipos de campo e a mesma ordem dos dois lados: o fluxo não contém marcadores de tipo ou versão. Ler um tipo diferente ou numa ordem diferente pode devolver valores incorretos sem lançar uma exceção.

writeByte(int) escreve apenas os oito bits menos significativos, sem verificar o intervalo. readByte() devolve um byte com sinal de −128 a 127; para obter um int de 0 a 255, usa antes readUnsignedByte(). writeInt(int) e readInt() usam quatro bytes por int em ordem big-endian, com o byte mais significativo primeiro. writeDouble(double) e readDouble() usam oito bytes no formato IEEE 754 binary64, na mesma ordem. A escrita usa Double.doubleToLongBits, que converte os NaN para uma representação canónica; a leitura usa Double.longBitsToDouble.

writeUTF(String) escreve um comprimento sem sinal de dois bytes em ordem big-endian, seguido dos dados em UTF-8 modificado. O limite de 65 535 conta os bytes de dados, excluindo o prefixo, não os caracteres nem String.length(). Não é UTF-8 padrão: U+0000 ocupa dois bytes e um carácter fora do plano multilingue básico ocupa seis, três por unidade de código UTF-16. O método de instância readUTF() lê do fluxo encapsulado; a sobrecarga estática DataInputStream.readUTF(DataInput) lê o mesmo formato a partir da origem fornecida.

Na escrita, uma cadeia codificada demasiado longa causa UTFDataFormatException, enquanto null causa NullPointerException. Na leitura, um fim prematuro dentro de um campo, do prefixo de comprimento ou dos dados da cadeia causa EOFException; se for detetada uma codificação malformada, é lançada UTFDataFormatException. Ambas são subtipos de IOException. Fechar o fluxo que encapsula o outro fecha também o fluxo subjacente; usa try com recursos quando fores responsável por fechá-lo.

O formato não depende da ordem dos bytes do processador nem da codificação predefinida da plataforma, mas um leitor fora de Java tem de implementar o mesmo formato. Valida os valores de registos não fidedignos segundo as regras da aplicação: uma descodificação bem-sucedida não torna os valores aceitáveis.

Exemplos

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

O programa mostra os bytes do registo, depois os valores lidos e o resultado da comparação das cadeias. `ff` é lido como `-1` com sinal; `00 03` anuncia três bytes de dados, embora a cadeia tenha duas unidades de código UTF-16.

Lições relacionadas

  • Java · Lição 53 · Avançado · Versão: 2

Fontes