CKTIS / Java
ByteBuffer: споделен масив, капацитет и четене без промяна на позицията
Използвай съществуващ масив от байтове без копиране, разграничи капацитета от границата и прочети байт по индекс, без да променяш позицията на буфера.
Версия: Java SE 21
Синтаксис
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();Статичният метод wrap на java.nio.ByteBuffer създава буфер върху съществуващ масив byte[], без да копира данните. Записът в масива се вижда в буфера, а записът през буфера променя същия масив. При ByteBuffer.wrap(array) началната позиция е 0, а границата и капацитетът са равни на array.length.
Претовареният вариант ByteBuffer.wrap(array, offset, length) задава начална позиция offset и граница offset + length, но капацитетът остава array.length. Трябва да са изпълнени 0 <= offset <= array.length и 0 <= length <= array.length - offset; иначе методът хвърля IndexOutOfBoundsException. Индекс 0 продължава да сочи към array[0], а не към array[offset].
Методът capacity(), наследен от java.nio.Buffer, връща постоянния капацитет на буфера в байтове, а не броя на оставащите байтове за относително четене. Този брой се връща от remaining() като limit() - position(). Винаги е изпълнено 0 <= position() <= limit() <= capacity().
get(index) прочита една стойност от тип byte по индекс, броен от началото на буфера, и не променя позицията. Индексът може да е по-малък от текущата позиция, но трябва да изпълнява 0 <= index < limit(); иначе методът хвърля IndexOutOfBoundsException. За разлика от него, относителният get() чете на текущата позиция и я увеличава с едно. Ако позицията е равна на границата, той хвърля BufferUnderflowException.
Примери
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]);
}
}Резултат
capacity=4 limit=3 get(0)=11 position=1 get()=20 position=2 data[2]=33
При позиция `1` и граница `3` извикването на `get(0)` прочита стойността `11`, записана в масива, и оставя позицията непроменена. Следващото извикване на `get()` връща `20` и премества позицията на `2`. Записът през буфера променя `data[2]` на `33`. `get(3)` би хвърлил изключение: `3` е равно на границата, въпреки че е по-малко от капацитета `4`.
Свързани уроци
- Java · Урок 60 · Средно · Версия: 2