CKTIS / Java
ByteBuffer: zdieľané pole, kapacita a čítanie bez zmeny pozície
Použi existujúce pole bajtov bez kopírovania, odlíš kapacitu od limitu a prečítaj bajt na zvolenom indexe bez zmeny pozície buffera.
Verzia: Java SE 21
Syntax
import java.nio.ByteBuffer;
ByteBuffer buffer = ByteBuffer.wrap(array);
ByteBuffer window = ByteBuffer.wrap(array, offset, length);
int capacity = buffer.capacity();
byte atIndex = buffer.get(index);
byte next = buffer.get();Statická metóda wrap triedy java.nio.ByteBuffer vytvorí buffer nad existujúcim poľom byte[] bez kopírovania údajov. Zápis do poľa je viditeľný v bufferi a zápis cez buffer mení to isté pole. Po volaní ByteBuffer.wrap(array) je počiatočná pozícia 0 a limit aj kapacita sa rovnajú array.length.
Preťažená verzia ByteBuffer.wrap(array, offset, length) nastaví počiatočnú pozíciu na offset a limit na offset + length, ale kapacita zostane array.length. Musí platiť 0 <= offset <= array.length a 0 <= length <= array.length - offset; inak metóda vyvolá IndexOutOfBoundsException. Index 0 stále zodpovedá prvku array[0], nie array[offset].
Metóda capacity(), zdedená z java.nio.Buffer, vracia pevnú kapacitu buffera v bajtoch, nie počet bajtov, ktoré zostávajú na relatívne čítanie. Ten vracia remaining() ako limit() - position(). Vždy platí 0 <= position() <= limit() <= capacity().
get(index) prečíta jeden byte na indexe počítanom od začiatku buffera a pozíciu nezmení. Index môže byť menší než aktuálna pozícia, musí však spĺňať 0 <= index < limit(); inak metóda vyvolá IndexOutOfBoundsException. Relatívne get() naopak číta na aktuálnej pozícii a zvýši ju o jeden. Ak sa pozícia rovná limitu, vyvolá BufferUnderflowException.
Príklady
import java.nio.ByteBuffer;
public class Main {
public static void main(String[] args) {
byte[] data = {10, 20, 30, 40};
ByteBuffer buffer = ByteBuffer.wrap(data, 1, 2);
System.out.println("capacity=" + buffer.capacity());
System.out.println("limit=" + buffer.limit());
data[0] = 11;
System.out.println("get(0)=" + buffer.get(0));
System.out.println("position=" + buffer.position());
System.out.println("get()=" + buffer.get());
System.out.println("position=" + buffer.position());
buffer.put(2, (byte) 33);
System.out.println("data[2]=" + data[2]);
}
}Výsledok
capacity=4 limit=3 get(0)=11 position=1 get()=20 position=2 data[2]=33
Pri pozícii `1` a limite `3` prečíta `get(0)` hodnotu `11` zapísanú do poľa a pozíciu nezmení. Nasledujúce `get()` vráti `20` a posunie pozíciu na `2`. Zápis cez buffer zmení `data[2]` na `33`. Volanie `get(3)` by vyvolalo výnimku: `3` sa rovná limitu, hoci je menšie než kapacita `4`.
Súvisiace lekcie
- Java · Lekcia 60 · Stredne pokročilá · Verzia: 2