CKTIS / Java
ByteBuffer — Binärdaten und Pufferzustand
ByteBuffer speichert Bytes und ermöglicht das Lesen und Schreiben binärer Werte. Lerne, wie du einen Puffer erstellst, die Byte-Reihenfolge festlegst und mit flip, clear und compact Position und Limit steuerst.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
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 ist ein Bytepuffer mit fester Kapazität, der auch für I/O verwendet wird. ByteBuffer.allocate(n) erstellt einen arraygestützten Puffer, während ByteBuffer.wrap(array) ein vorhandenes Array ohne Kopieren gemeinsam nutzt. ByteBuffer.allocateDirect(n) erstellt einen direkten Puffer: Die JVM versucht, das Kopieren bei nativer I/O zu verringern, eine höhere Geschwindigkeit ist jedoch nicht garantiert. ByteBuffer.isDirect() erkennt diese Pufferart.
ByteBuffer.capacity() gibt die feste Kapazität in Bytes zurück. ByteBuffer.position() bezeichnet das nächste Byte und ByteBuffer.limit() den ersten nicht zugänglichen Index; Überladungen mit Argument setzen diese Werte. Es gilt 0 <= position <= limit <= capacity, und ByteBuffer.remaining() entspricht limit - position.
ByteBuffer.put und ByteBuffer.get schreiben und lesen Bytes. ByteBuffer.putInt / ByteBuffer.getInt verarbeiten 4 Bytes und ByteBuffer.putShort / ByteBuffer.getShort 2 Bytes. Relative Operationen erhöhen die Position; indexierte Überladungen tun dies nicht, beachten aber weiterhin das Limit. ByteBuffer.order() liest die Byte-Reihenfolge aus, und order(ByteOrder.LITTLE_ENDIAN) ändert sie; standardmäßig gilt BIG_ENDIAN. Reicht bei einer relativen Operation der Platz oder die Datenmenge nicht aus, wird entsprechend BufferOverflowException oder BufferUnderflowException ausgelöst.
Nach dem Schreiben setzt ByteBuffer.flip() das Limit auf die vorherige Position und die Position auf null. ByteBuffer.compact() verschiebt ungelesene Bytes an den Anfang, setzt die Position hinter diese Bytes und das Limit auf die Kapazität, sodass weitere Daten angefügt werden können. ByteBuffer.clear() setzt die Position auf null und das Limit auf die Kapazität, löscht aber keine Daten. Bei gleichzeitigem Zugriff ist Synchronisierung erforderlich.
Beispiele
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());
}
}
Ergebnis
7 8 8 16909060 7 2 9 10 0 8
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.