Класс Buffer

Буфер — это линейная, конечная последовательность элементов определённого примитивного типа. Помимо своего содержимого, важными свойствами буфера являются его емкость, предел и позиция:

Емкость буфера — это количество элементов, которые он содержит. Емкость буфера никогда не бывает отрицательной и никогда не меняется.

Предел буфера — это индекс первого элемента, который не должен читаться или записываться. Предел буфера никогда не бывает отрицательным и никогда не бывает больше его емкости.

Позиция буфера — это индекс следующего элемента для чтения или записи. Позиция буфера никогда не бывает отрицательной и никогда не бывает больше предела.

Для каждого примитивного типа (кроме boolean) существует один подкласс этого класса.

Передача данных

Каждый подкласс этого класса определяет два типа операций get и put:

Относительные операции читают или записывают один или несколько элементов, начиная с текущей позиции, а затем увеличивают позицию на количество переданных элементов. Если запрашиваемая передача превышает предел, то относительная операция get вызывает исключение BufferUnderflowException, а относительная операция put вызывает исключение BufferOverflowException; в любом случае данные не передаются.

Абсолютные операции принимают явный индекс элемента и не влияют на позицию. Абсолютные операции get и put вызывают исключение IndexOutOfBoundsException, если аргумент индекса превышает предел.

Данные также могут, конечно, передаваться в буфер или из него операциями ввода-вывода соответствующего канала, которые всегда относительны к текущей позиции.

Пометка и сброс

Пометка буфера — это индекс, к которому будет сброшена его позиция при вызове метода reset. Пометка не всегда определена, но когда она определена, она никогда не бывает отрицательной и никогда не бывает больше позиции. Если пометка определена, она отбрасывается, когда позиция или предел устанавливаются в значение, меньшее пометки. Если пометка не определена, вызов метода reset вызывает исключение InvalidMarkException.

Инварианты

Для значений пометки, позиции, предела и емкости выполняется следующий инвариант:

0 <= пометка <= позиция <= предел <= емкость

Недавно созданный буфер всегда имеет позицию 0 и неопределённую пометку. Начальный предел может быть 0 или каким-то другим значением, которое зависит от типа буфера и способа его создания. Каждый элемент только что выделенного буфера инициализируется нулём.

Дополнительные операции

В дополнение к методам для доступа к значениям позиции, предела и емкости, а также для пометки и сброса, этот класс также определяет следующие операции над буферами:

• clear() подготавливает буфер к новой последовательности операций чтения канала или относительных операций put: Он устанавливает предел в емкость, а позицию в ноль.

• flip() подготавливает буфер к новой последовательности операций записи канала или относительных операций get: Он устанавливает предел в текущую позицию, а затем позицию в ноль.

• rewind() подготавливает буфер к повторному чтению данных, которые он уже содержит: Он оставляет предел неизменным и устанавливает позицию в ноль.

• Методы slice() и slice(index,length) создают подпоследовательность буфера: они оставляют предел и позицию неизменными.

• duplicate() создаёт поверхностную копию буфера: он оставляет предел и позицию неизменными.

Буферы только для чтения

Каждый буфер читается, но не каждый буфер записывается. Методы изменения каждого класса буфера определены как необязательные операции, которые будут вызывать исключение ReadOnlyBufferException при вызове для буфера только для чтения. Буфер только для чтения не позволяет изменять его содержимое, но значения пометки, позиции и предела изменяемы. Читается ли буфер только для чтения, можно определить, вызвав его метод isReadOnly.

Поток безопасности

Буферы не предназначены для одновременного использования несколькими потоками. Если буфер будет использоваться более чем одним потоком, доступ к буферу должен контролироваться соответствующей синхронизацией.

Цепочки вызовов

Методы в этом классе, которые не возвращают значение, возвращают буфер, на котором они вызываются. Это позволяет цеплять вызовы методов; например, последовательность операторов

    b.flip();
    b.position(23);
    b.limit(42);

    b.flip().position(23).limit(42);