База знанияИзпитен център
BGБългарски
Избери език13

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

Източници