Класс 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);