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