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

CKTIS / Java

Ordem dos bytes em Java: LITTLE_ENDIAN e BIG_ENDIAN

Escolhe a ordem dos bytes para valores com vários bytes num `ByteBuffer` e usa-a tanto na escrita como na leitura. A ordem predefinida do buffer não depende do hardware.

Versão: Java SE 21

Sintaxe

import java.nio.ByteBuffer;
import java.nio.ByteOrder;

ByteBuffer big = ByteBuffer.allocate(4).order(ByteOrder.BIG_ENDIAN);
ByteBuffer little = ByteBuffer.allocate(4).order(ByteOrder.LITTLE_ENDIAN);

ByteOrder.BIG_ENDIAN e ByteOrder.LITTLE_ENDIAN são constantes public static final do tipo java.nio.ByteOrder. Em big-endian, o byte mais significativo vem primeiro; em little-endian, vem primeiro o menos significativo. Para o valor int 0x01020304, as sequências são, respetivamente, 01 02 03 04 e 04 03 02 01. A ordem dos bits dentro de cada byte não muda.

Em Java SE 21, um novo ByteBuffer começa em BIG_ENDIAN, mesmo quando é criado com wrap(byte[]). order() devolve a ordem atual; order(ByteOrder) altera a configuração desse buffer sem reordenar os bytes já guardados. ByteOrder.nativeOrder() devolve a ordem nativa da plataforma, não a ordem predefinida do buffer. Para um ficheiro ou protocolo, segue a ordem definida pelo formato, não a do hardware.

putInt(int) escreve quatro bytes e getInt() lê quatro. Ambos partem da posição atual e fazem-na avançar quatro. As sobrecargas com índice de byte, putInt(int, int) e getInt(int), deixam a posição inalterada. Lê pela mesma ordem usada na escrita. Se leres 04 03 02 01 como big-endian, obténs 0x04030201 sem que uma exceção assinale a ordem incorreta.

Exemplos

import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import java.util.HexFormat;

public class ByteOrderDemo {
    public static void main(String[] args) {
        System.out.println("Default: " + ByteBuffer.allocate(4).order());
        roundTrip(ByteOrder.BIG_ENDIAN);
        roundTrip(ByteOrder.LITTLE_ENDIAN);
    }

    private static void roundTrip(ByteOrder order) {
        ByteBuffer writer = ByteBuffer.allocate(4).order(order);
        writer.putInt(0x01020304);
        byte[] bytes = writer.array();

        ByteBuffer reader = ByteBuffer.wrap(bytes).order(order);
        int decoded = reader.getInt();

        HexFormat hex = HexFormat.ofDelimiter(" ");
        System.out.println(order + ": " + hex.formatHex(bytes)
                + " -> 0x" + hex.toHexDigits(decoded));
    }
}

Resultado

Default: BIG_ENDIAN
BIG_ENDIAN: 01 02 03 04 -> 0x01020304
LITTLE_ENDIAN: 04 03 02 01 -> 0x01020304

A primeira linha mostra a ordem predefinida. Em cada teste, `wrap(byte[])` cria um buffer de leitura separado sobre o mesmo array, na posição 0. Ao definir explicitamente a mesma ordem, recuperas `0x01020304` a partir das duas sequências de bytes.

Lições relacionadas

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

Fontes