CKTIS / Java
ByteBuffer — données binaires et état du tampon
ByteBuffer stocke des octets et permet de lire et d’écrire des valeurs binaires. Découvrez la création d’un tampon, l’ordre des octets et la façon dont flip, clear et compact contrôlent position et limit.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
ByteBuffer b = ByteBuffer.allocate(capacity).order(ByteOrder.BIG_ENDIAN);
b.putInt(value).putShort((short) count);
b.flip();
int valueRead = b.getInt();
short countRead = b.getShort();java.nio.ByteBuffer est un tampon d’octets de capacité fixe, également utilisé pour les opérations d’E/S. ByteBuffer.allocate(n) crée un tampon adossé à un tableau, tandis que ByteBuffer.wrap(array) partage un tableau existant sans le copier. ByteBuffer.allocateDirect(n) crée un tampon direct : la JVM tente de réduire les copies lors des E/S natives, mais n’assure pas de meilleures performances. ByteBuffer.isDirect() reconnaît ce type de tampon.
ByteBuffer.capacity() renvoie la capacité fixe en octets. ByteBuffer.position() indique l’octet suivant et ByteBuffer.limit() le premier index inaccessible ; les surcharges prenant un argument définissent ces valeurs. L’invariant est 0 <= position <= limit <= capacity, et ByteBuffer.remaining() vaut limit - position.
ByteBuffer.put et ByteBuffer.get écrivent et lisent des octets. ByteBuffer.putInt / ByteBuffer.getInt traitent 4 octets et ByteBuffer.putShort / ByteBuffer.getShort en traitent 2. Les opérations relatives avancent la position ; les surcharges indexées ne la modifient pas, mais respectent toujours la limite. ByteBuffer.order() récupère l’ordre des octets et order(ByteOrder.LITTLE_ENDIAN) le modifie ; l’ordre par défaut est BIG_ENDIAN. Si l’espace ou les données sont insuffisants lors d’une opération relative, une BufferOverflowException ou une BufferUnderflowException est levée, respectivement.
Après l’écriture, ByteBuffer.flip() définit la limite sur la position précédente et la position sur zéro. ByteBuffer.compact() déplace les octets non lus au début, place la position juste après eux et définit la limite sur la capacité, ce qui permet d’ajouter des données. ByteBuffer.clear() remet la position à zéro et la limite à la capacité, mais n’efface pas les données. L’accès concurrent à un tampon nécessite une synchronisation.
Exemples
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
public class Main {
public static void main(String[] args) {
ByteBuffer b = ByteBuffer.allocate(8).order(ByteOrder.LITTLE_ENDIAN);
b.putInt(16909060).putShort((short) 7).put((byte) 9);
System.out.println(b.position() + " " + b.limit() + " " + b.capacity());
b.flip();
System.out.println(b.getInt() + " " + b.getShort());
b.compact();
b.put((byte) 10);
b.flip();
System.out.println(b.remaining() + " " + b.get() + " " + b.get());
b.clear();
System.out.println(b.position() + " " + b.limit());
}
}
Résultat
7 8 8 16909060 7 2 9 10 0 8
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.