Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Ordre des octets en Java : LITTLE_ENDIAN et BIG_ENDIAN

Choisissez l’ordre des octets pour les valeurs multioctets d’un `ByteBuffer` et utilisez-le à l’écriture comme à la lecture. L’ordre par défaut du tampon ne dépend pas du matériel.

Version : Java SE 21

Syntaxe

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 et ByteOrder.LITTLE_ENDIAN sont des constantes public static final de type java.nio.ByteOrder. En big-endian, l’octet de poids fort vient en premier ; en little-endian, c’est l’octet de poids faible. Pour la valeur int 0x01020304, on obtient respectivement 01 02 03 04 et 04 03 02 01. L’ordre des bits à l’intérieur d’un octet ne change pas.

Dans Java SE 21, un nouveau ByteBuffer est initialement en BIG_ENDIAN, même s’il est créé avec wrap(byte[]). order() renvoie l’ordre courant ; order(ByteOrder) modifie le réglage de ce tampon sans réorganiser les octets déjà stockés. ByteOrder.nativeOrder() indique l’ordre natif de la plateforme, pas le réglage par défaut du tampon. Pour un fichier ou un protocole, suivez l’ordre imposé par le format plutôt que celui du matériel.

putInt(int) écrit quatre octets et getInt() en lit quatre. Les deux méthodes partent de la position courante et l’avancent de quatre. Les surcharges avec un indice d’octet, putInt(int, int) et getInt(int), ne déplacent pas la position. À la lecture, utilisez le même ordre qu’à l’écriture. Lire 04 03 02 01 en big-endian donne 0x04030201 sans exception signalant l’erreur d’ordre.

Exemples

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));
    }
}

Résultat

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

La première ligne indique l’ordre par défaut. À chaque aller-retour, `wrap(byte[])` crée un tampon de lecture distinct sur le même tableau, en position 0. En réglant explicitement le même ordre, on retrouve `0x01020304` pour les deux séquences d’octets.

Leçons associées

  • Java · Leçon 50 · Avancé · Version : 2

Sources