CKTIS / Java
ByteBuffer — binární data a stav bufferu
ByteBuffer ukládá bajty a umožňuje číst a zapisovat binární hodnoty. Naučte se vytvářet buffer, nastavit pořadí bajtů a řídit position a limit pomocí flip, clear a compact.
Verze: 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 je bajtový buffer s pevnou kapacitou, který se používá také pro I/O. ByteBuffer.allocate(n) vytvoří buffer s podkladovým polem, zatímco ByteBuffer.wrap(array) sdílí existující pole bez kopírování. ByteBuffer.allocateDirect(n) vytvoří přímý buffer: JVM se pokouší omezit kopírování při nativním I/O, ale vyšší rychlost nezaručuje. ByteBuffer.isDirect() tento typ bufferu rozpozná.
ByteBuffer.capacity() vrací pevnou kapacitu v bajtech. ByteBuffer.position() označuje následující bajt a ByteBuffer.limit() první nepřístupný index; přetížené metody s argumentem tyto hodnoty nastavují. Platí 0 <= position <= limit <= capacity a ByteBuffer.remaining() se rovná limit - position.
ByteBuffer.put a ByteBuffer.get zapisují a čtou bajty. ByteBuffer.putInt / ByteBuffer.getInt zpracovávají 4 bajty a ByteBuffer.putShort / ByteBuffer.getShort 2 bajty. Relativní operace posouvají pozici; indexované přetížené metody ji neposouvají, ale stále respektují limit. ByteBuffer.order() zjišťuje pořadí bajtů a order(ByteOrder.LITTLE_ENDIAN) je mění; výchozí je BIG_ENDIAN. Pokud při relativní operaci není dostatek místa nebo dat, dojde k BufferOverflowException, respektive BufferUnderflowException.
Po zápisu nastaví ByteBuffer.flip() limit na předchozí pozici a pozici na nulu. ByteBuffer.compact() přesune nepřečtené bajty na začátek, nastaví pozici hned za ně a limit na kapacitu, takže lze přidat další data. ByteBuffer.clear() nastaví pozici na nulu a limit na kapacitu, ale data nesmaže. Souběžný přístup k bufferu vyžaduje synchronizaci.
Příklady
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());
}
}
Výsledek
7 8 8 16909060 7 2 9 10 0 8
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.