CKTIS / Java
ByteBuffer — binárne údaje a stav buffera
ByteBuffer ukladá bajty a umožňuje čítať a zapisovať binárne hodnoty. Naučte sa vytvárať buffer, nastaviť poradie bajtov a riadiť position a limit pomocou flip, clear a compact.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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, ktorý sa používa aj pri operáciách I/O. ByteBuffer.allocate(n) vytvorí buffer s podkladovým poľom, zatiaľ čo ByteBuffer.wrap(array) zdieľa existujúce pole bez kopírovania. ByteBuffer.allocateDirect(n) vytvorí priamy buffer: JVM sa pokúša obmedziť kopírovanie pri natívnom I/O, no vyššiu rýchlosť nezaručuje. ByteBuffer.isDirect() rozpozná tento typ buffera.
ByteBuffer.capacity() vráti pevnú kapacitu v bajtoch. ByteBuffer.position() označuje nasledujúci bajt a ByteBuffer.limit() prvý neprístupný index; preťažené metódy s argumentom tieto hodnoty nastavia. Platí 0 <= position <= limit <= capacity a ByteBuffer.remaining() sa rovná limit - position.
ByteBuffer.put a ByteBuffer.get zapisujú a čítajú bajty. ByteBuffer.putInt / ByteBuffer.getInt spracujú 4 bajty a ByteBuffer.putShort / ByteBuffer.getShort 2 bajty. Relatívne operácie posúvajú pozíciu; indexované preťažené metódy ju neposúvajú, ale stále rešpektujú limit. ByteBuffer.order() zistí poradie bajtov a order(ByteOrder.LITTLE_ENDIAN) ho zmení; predvolené je BIG_ENDIAN. Ak pri relatívnej operácii nie je dostatok miesta alebo údajov, nastane BufferOverflowException, respektíve BufferUnderflowException.
Po zápise nastaví ByteBuffer.flip() limit na predchádzajúcu pozíciu a pozíciu na nulu. ByteBuffer.compact() presunie neprečítané bajty na začiatok, nastaví pozíciu hneď za ne a limit na kapacitu, aby bolo možné pridať ďalšie údaje. ByteBuffer.clear() nastaví pozíciu na nulu a limit na kapacitu, ale údaje nevymaže. Súbežný prístup k bufferu vyžaduje synchronizáciu.
Prí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ýsledok
7 8 8 16909060 7 2 9 10 0 8
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.