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