Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje