CKTIS / Java
ByteBuffer: tablica współdzielona, pojemność i odczyt bez zmiany pozycji
Użyj istniejącej tablicy bajtów bez kopiowania, odróżnij pojemność od limitu i odczytaj bajt pod wybranym indeksem bez zmiany pozycji bufora.
Wersja: Java SE 21
Składnia
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();Statyczna metoda wrap klasy java.nio.ByteBuffer tworzy bufor oparty na istniejącej tablicy byte[], bez kopiowania danych. Zapis do tablicy jest widoczny w buforze, a zapis do bufora zmienia tę samą tablicę. Po wywołaniu ByteBuffer.wrap(array) pozycja wynosi 0, a limit i pojemność są równe array.length.
Wariant ByteBuffer.wrap(array, offset, length) ustawia początkową pozycję na offset, a limit na offset + length, ale pojemność nadal wynosi array.length. Wymagane jest 0 <= offset <= array.length i 0 <= length <= array.length - offset; w przeciwnym razie metoda zgłasza IndexOutOfBoundsException. Indeks 0 nadal odpowiada array[0], a nie array[offset].
Metoda capacity(), odziedziczona z java.nio.Buffer, zwraca stałą pojemność bufora w bajtach. Nie jest to liczba bajtów pozostałych do odczytu względnego: remaining() zwraca limit() - position(). Obowiązuje 0 <= position() <= limit() <= capacity().
Wywołanie get(index) odczytuje jeden byte spod indeksu liczonego od początku bufora i nie zmienia pozycji. Indeks może leżeć przed bieżącą pozycją, ale musi spełniać 0 <= index < limit(); inaczej metoda zgłasza IndexOutOfBoundsException. Natomiast get() odczytuje bajt z bieżącej pozycji i zwiększa ją o jeden; na pozycji równej limitowi zgłasza BufferUnderflowException.
Przykłady
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]);
}
}Wynik
capacity=4 limit=3 get(0)=11 position=1 get()=20 position=2 data[2]=33
Przy pozycji `1` i limicie `3` wywołanie `get(0)` widzi wartość `11` zapisaną w tablicy i pozostawia pozycję bez zmian. Następne `get()` zwraca `20` i przesuwa pozycję na `2`. Zapis przez bufor zmienia `data[2]` na `33`. Wywołanie `get(3)` zgłosiłoby wyjątek: indeks `3` jest równy limitowi, choć jest mniejszy od pojemności `4`.
Powiązane lekcje
- Java · Lekcja 60 · Średniozaawansowany · Wersja: 2