Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ByteBuffer — dane binarne i stan bufora

ByteBuffer przechowuje bajty i umożliwia odczyt oraz zapis wartości binarnych. Poznaj tworzenie bufora, kolejność bajtów oraz sterowanie position i limit za pomocą flip, clear i compact.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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 jest buforem bajtów o stałej pojemności, używanym także w operacjach I/O. ByteBuffer.allocate(n) tworzy bufor z tablicą, a ByteBuffer.wrap(array) współdzieli istniejącą tablicę bez kopiowania. ByteBuffer.allocateDirect(n) tworzy bufor bezpośredni: JVM próbuje ograniczyć kopiowanie przy natywnym I/O, ale nie gwarantuje przyspieszenia. ByteBuffer.isDirect() rozpoznaje ten rodzaj bufora.

ByteBuffer.capacity() zwraca stałą pojemność w bajtach. ByteBuffer.position() wskazuje następny bajt, a ByteBuffer.limit() — pierwszy niedostępny indeks; przeciążenia z argumentem ustawiają te wartości. Obowiązuje 0 <= position <= limit <= capacity, a ByteBuffer.remaining() wynosi limit - position.

ByteBuffer.put i ByteBuffer.get zapisują i odczytują bajty. ByteBuffer.putInt / ByteBuffer.getInt obsługują 4 bajty, a ByteBuffer.putShort / ByteBuffer.getShort — 2 bajty. Operacje względne przesuwają pozycję; przeciążenia z indeksem nie przesuwają jej, lecz nadal respektują limit. ByteBuffer.order() odczytuje kolejność bajtów, a order(ByteOrder.LITTLE_ENDIAN) ją zmienia; domyślna to BIG_ENDIAN. Niedobór miejsca lub danych przy operacji względnej powoduje odpowiednio BufferOverflowException lub BufferUnderflowException.

Po zapisie ByteBuffer.flip() ustawia limit na dotychczasową pozycję i pozycję na zero. ByteBuffer.compact() przenosi nieodczytane bajty na początek, ustawia pozycję za nimi i limit na pojemność, umożliwiając dopisanie danych. ByteBuffer.clear() ustawia pozycję na zero i limit na pojemność, ale nie wymazuje danych. Bufor wymaga synchronizacji przy współbieżnym dostępie.

Przykłady

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());
    }
}

Wynik

7 8 8
16909060 7
2 9 10
0 8

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła