Класс Buffer

public abstract class Buffer
extends Object

Контейнер для данных определённого примитивного типа.

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

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

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

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

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

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

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

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

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

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

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

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

Инварианты

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

0 <= mark <= position <= limit <= capacity

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

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

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

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

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

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

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

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

Читаемые буферы

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

Безопасность потоков

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

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

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

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

может быть заменена одним более компактным оператором

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