CKTIS / Java
Přímý ByteBuffer: zápis, čtení a zachování nepřečtených bajtů
Zapiš šest bajtů do přímého bufferu o kapacitě 32 bajtů a sleduj, jak `flip()`, `compact()` a `clear()` mění rozsah pro čtení nebo zápis.
Verze: Java SE 21
Syntaxe
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
ByteBuffer b = ByteBuffer.allocateDirect(32);
b.isDirect();
b.capacity();
b.order();
b.order(ByteOrder.LITTLE_ENDIAN);
b.position();
b.position(newPosition);
b.limit();
b.limit(newLimit);
b.putInt(intValue);
b.putInt(byteIndex, intValue);
b.putShort(shortValue);
b.putShort(byteIndex, shortValue);
b.getInt();
b.getInt(byteIndex);
b.getShort();
b.getShort(byteIndex);
b.clear();
b.flip();
b.compact();V Java SE 21 vytvoří statická metoda java.nio.ByteBuffer.allocateDirect(n) přímý buffer pro n bajtů. Záporná kapacita vyvolá IllegalArgumentException. isDirect() zjistí, zda je buffer přímý. JVM se při nativním vstupu a výstupu snaží vyhnout mezikopiím, ale nezaručuje to. Obsah může být mimo haldu Javy. Žádná ze zde popsaných operací neuvolní paměť bufferu.
capacity() vrací pevnou kapacitu v bajtech, position() určuje index dalšího bajtu pro relativní přístup a limit() první nepřístupný index. Zpočátku je pozice 0, limit se rovná kapacitě a bajty jsou vynulované. position(p) vyžaduje 0 <= p <= limit; limit(l) vyžaduje 0 <= l <= capacity a podle potřeby sníží pozici na l. Neplatný argument vyvolá IllegalArgumentException. Každá z těchto metod zruší značku, pokud přesahuje novou pozici, respektive nový limit.
order() vrací pořadí bajtů, zpočátku ByteOrder.BIG_ENDIAN (nejvýznamnější bajt první). order(ByteOrder.LITTLE_ENDIAN) nastaví pro další vícebajtové přístupy nejméně významný bajt jako první, aniž by přeuspořádala uložené bajty. Řiď se formátem dat, nikoli pořadím procesoru.
putInt(value) a getInt() zapisují nebo čtou čtyři bajty; putShort(value) a getShort() dva. Relativní operace začínají na position() a posunou ji o velikost hodnoty. Pokud je limit - position příliš malé, čtení vyvolá BufferUnderflowException a zápis do bufferu, který zápis umožňuje, vyvolá BufferOverflowException. Pokus o zápis do bufferu jen pro čtení může vyvolat ReadOnlyBufferException. Pokud v bufferu jen pro čtení zároveň zbývá příliš málo místa pro relativní zápis, Java SE 21 neurčuje, která z těchto dvou výjimek při zápisu má přednost. Absolutní přetížení getInt(i), getShort(i), putInt(i, value) a putShort(i, value) pozici nemění. Celý jejich rozsah bajtů musí ležet v [0, limit), jinak vyvolají IndexOutOfBoundsException.
flip() nastaví limit na původní pozici a pozici na 0, aby bylo možné číst. clear() nastaví pozici na 0 a limit na kapacitu, aby šlo celý buffer znovu zaplnit, ale data nesmaže. Po částečném čtení přesune compact() bajty z [position, limit) na začátek, nastaví pozici na počet zachovaných bajtů a obnoví limit na kapacitu, aby šlo připsat další data. Před dalším čtením zavolej flip(). Všechny tři metody ruší značku; compact() u bufferu jen pro čtení vyvolá ReadOnlyBufferException.
Příklady
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
public class Main {
public static void main(String[] args) {
ByteBuffer b = ByteBuffer.allocateDirect(32).order(ByteOrder.LITTLE_ENDIAN);
System.out.println("direct=" + b.isDirect() + ", capacity=" + b.capacity()
+ ", order=" + b.order());
b.putInt(0x01020304).putShort((short) 200);
state("after put", b);
b.flip();
state("after flip", b);
System.out.println("first byte=" + b.get(0));
System.out.println("int=" + b.getInt());
state("after getInt", b);
b.compact();
state("after compact", b);
b.putShort((short) 300);
b.flip();
state("after second flip", b);
short retained = b.getShort();
short appended = b.getShort();
System.out.println("shorts=" + retained + ", " + appended);
b.clear();
state("after clear", b);
}
private static void state(String label, ByteBuffer b) {
System.out.println(label + ": position=" + b.position() + ", limit=" + b.limit());
}
}Výsledek
direct=true, capacity=32, order=LITTLE_ENDIAN after put: position=6, limit=32 after flip: position=0, limit=6 first byte=4 int=16909060 after getInt: position=4, limit=6 after compact: position=2, limit=32 after second flip: position=0, limit=4 shorts=200, 300 after clear: position=0, limit=32
Data zabírají šest z 32 bajtů. Absolutní volání `get(0)` ukáže nejméně významný bajt (`4`), aniž by posunulo pozici. Po přečtení `int` zachová `compact()` dva bajty hodnoty `200`; po připsání `300` zpřístupní druhé `flip()` obě hodnoty ke čtení. `clear()` obnoví celý rozsah pro zápis.
Související lekce
- Java · Lekce 50 · Pokročilá · Verze: 2