CKTIS / Java
Priamy ByteBuffer: zápis, čítanie a zachovanie neprečítaných bajtov
Zapíš šesť bajtov do priameho 32-bajtového buffera a sleduj, ako `flip()`, `compact()` a `clear()` menia rozsah dostupný na čítanie alebo zápis.
Verzia: Java SE 21
Syntax
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 statická metóda java.nio.ByteBuffer.allocateDirect(n) vytvorí priamy buffer pre n bajtov. Záporná kapacita vyvolá IllegalArgumentException. isDirect() zisťuje, či je buffer priamy. JVM sa pri natívnom vstupe a výstupe snaží vyhnúť medzikópiám, ale nezaručuje to. Obsah môže byť mimo haldy Javy. Žiadna z tu opísaných operácií neuvoľní pamäť buffera.
capacity() vracia pevnú kapacitu v bajtoch, position() určuje index ďalšieho bajtu pri relatívnom prístupe a limit() prvý neprístupný index. Na začiatku je pozícia 0, limit sa rovná kapacite a bajty sú vynulované. position(p) vyžaduje 0 <= p <= limit; limit(l) vyžaduje 0 <= l <= capacity a podľa potreby zníži pozíciu na l. Neplatný argument vyvolá IllegalArgumentException. Každá z týchto metód zruší značku, ak je za novou pozíciou, respektíve za novým limitom.
order() vracia poradie bajtov, spočiatku ByteOrder.BIG_ENDIAN (najvýznamnejší bajt je prvý). order(ByteOrder.LITTLE_ENDIAN) pri nasledujúcich viacbajtových prístupoch použije najmenej významný bajt ako prvý bez zmeny poradia uložených bajtov. Riaď sa formátom dát, nie poradím procesora.
putInt(value) a getInt() zapisujú alebo čítajú štyri bajty; putShort(value) a getShort() dva. Relatívne operácie začínajú na position() a posunú ju o veľkosť hodnoty. Ak je limit - position primalé, čítanie vyvolá BufferUnderflowException a zápis do buffera, ktorý umožňuje zápis, vyvolá BufferOverflowException. Pokus o zápis do buffera iba na čítanie môže vyvolať ReadOnlyBufferException. Ak v bufferi iba na čítanie zároveň nezostáva dosť miesta na relatívny zápis, Java SE 21 neurčuje, ktorá z týchto dvoch výnimiek pri zápise má prednosť. Absolútne preťaženia getInt(i), getShort(i), putInt(i, value) a putShort(i, value) pozíciu nemenia. Celý ich rozsah bajtov musí ležať v [0, limit), inak vyvolajú IndexOutOfBoundsException.
flip() nastaví limit na pôvodnú pozíciu a pozíciu na 0, aby sa dalo čítať. clear() nastaví pozíciu na 0 a limit na kapacitu, aby sa dal znova zaplniť celý buffer, ale dáta nevymaže. Po čiastočnom čítaní compact() presunie bajty z [position, limit) na začiatok, nastaví pozíciu na počet zachovaných bajtov a obnoví limit na kapacitu, aby sa dali pripísať dáta. Pred ďalším čítaním zavolaj flip(). Všetky tri metódy rušia značku; compact() pri bufferi iba na čítanie vyvolá ReadOnlyBufferException.
Prí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ýsledok
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
Dáta zaberajú šesť z 32 bajtov. Absolútne volanie `get(0)` ukáže najmenej významný bajt (`4`) bez posunutia pozície. Po prečítaní `int` metóda `compact()` zachová dva bajty hodnoty `200`; po pripísaní `300` druhé `flip()` sprístupní obe hodnoty na čítanie. `clear()` obnoví celý rozsah na zápis.
Súvisiace lekcie
- Java · Lekcia 50 · Pokročilá · Verzia: 2