CKTIS / Java
ByteBuffer — binarni podaci i stanje međuspremnika
ByteBuffer pohranjuje bajtove i omogućuje čitanje i zapisivanje binarnih vrijednosti. Naučite kako stvoriti međuspremnik, postaviti redoslijed bajtova te upravljati position i limit pomoću flip, clear i compact.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
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 međuspremnik bajtova fiksnog kapaciteta koji se koristi i za I/O. ByteBuffer.allocate(n) stvara međuspremnik s poljem kao podlogom, dok ByteBuffer.wrap(array) dijeli postojeće polje bez kopiranja. ByteBuffer.allocateDirect(n) stvara izravni međuspremnik: JVM pokušava smanjiti kopiranje tijekom izvornog I/O-a, ali ne jamči veću brzinu. ByteBuffer.isDirect() prepoznaje tu vrstu međuspremnika.
ByteBuffer.capacity() vraća fiksni kapacitet u bajtovima. ByteBuffer.position() označava sljedeći bajt, a ByteBuffer.limit() prvi nedostupni indeks; preopterećene metode s argumentom postavljaju te vrijednosti. Vrijedi 0 <= position <= limit <= capacity, a ByteBuffer.remaining() jednak je limit - position.
ByteBuffer.put i ByteBuffer.get zapisuju i čitaju bajtove. ByteBuffer.putInt / ByteBuffer.getInt obrađuju 4 bajta, a ByteBuffer.putShort / ByteBuffer.getShort 2 bajta. Relativne operacije pomiču poziciju; indeksirane preopterećene metode je ne pomiču, ali i dalje poštuju limit. ByteBuffer.order() dohvaća redoslijed bajtova, a order(ByteOrder.LITTLE_ENDIAN) mijenja ga; zadani je BIG_ENDIAN. Ako u relativnoj operaciji nema dovoljno prostora ili podataka, dolazi do BufferOverflowException, odnosno BufferUnderflowException.
Nakon zapisivanja ByteBuffer.flip() postavlja limit na prethodnu poziciju, a poziciju na nulu. ByteBuffer.compact() premješta nepročitane bajtove na početak, postavlja poziciju odmah iza njih i limit na kapacitet, što omogućuje dodavanje podataka. ByteBuffer.clear() postavlja poziciju na nulu i limit na kapacitet, ali ne briše podatke. Istodobni pristup međuspremniku zahtijeva sinkronizaciju.
Primjeri
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());
}
}
Rezultat
7 8 8 16909060 7 2 9 10 0 8
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.