DataBuffer

Посещает резервное хранилище этого буфера.

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

Запишите ссылки на объекты исходного массива в этот буфер.

Если значений для копирования больше, чем размер целевого буфера, т. е. size > dst.size() , значения не передаются и выдается исключение BufferOverflowException. С другой стороны, если копируемых значений больше, чем размер исходного буфера, т. е. > src.size() , то генерируется исключение BufferUnderfloatException.

В противном случае этот метод копирует значения n = size из этого буфера в целевой буфер.

Проверяет равенство между буферами данных.

Буфер данных равен другому объекту, если этот объект является другим DataBuffer того же размера, типа и элементы равны и находятся в том же порядке. Например:

IntDataBuffer buffer = DataBuffers.of(1, 2, 3);

 assertEquals(buffer, DataBuffers.of(1, 2, 3));  // true
 assertEquals(buffer, DataBuffers.ofObjects(1, 2, 3));  // true, as Integers are equal to ints
 assertNotEquals(buffer, DataBuffers.of(1, 2, 3, 0));  // false, different sizes
 assertNotEquals(buffer, DataBuffers.of(1, 3, 2));  // false, different order
 assertNotEquals(buffer, DataBuffers.of(1L, 2L, 3L));  // false, different types
 

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

Считывает значение по заданному индексу. Важно: Использование этого метода должно быть ограничено буферами не примитивных типов или когда тип данных не детерминированно известен вызывающей стороне. В любом другом случае предпочтительнее использовать его примитивный вариант, который значительно улучшит производительность (например, IntDataBuffer.getInt(idx)

Сообщает, поддерживается ли этот буфер доступным массивом.

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

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

Этот вызов эквивалентен slice(0, size)

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

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

Этот вызов эквивалентен slice(index, size() - index)

Считайте ссылки на объекты в этом буфере в целевой массив.

Этот метод передает значения из этого буфера в заданный массив назначения. Если в буфере меньше значений, чем требуется для удовлетворения запроса, то есть если dst.length > size() , значения не передаются и создается исключение BufferUnderflowException.

В противном случае этот метод копирует значения n = dst.length из этого буфера в заданный массив.

Считайте ссылки на объекты в этом буфере в целевой массив.

Этот метод передает значения из этого буфера в заданный массив назначения. Если в буфере меньше значений, чем требуется для удовлетворения запроса, то есть если length > size() , значения не передаются и создается исключение BufferUnderflowException.

В противном случае этот метод копирует значения n = length из этого буфера в заданный массив, начиная с заданного смещения.

Записывает заданное значение в этот буфер по заданному индексу. Важно: Использование этого метода должно быть ограничено буферами не примитивных типов или когда тип данных не детерминированно известен вызывающей стороне. В любом другом случае предпочтительнее использовать его примитивный вариант, который значительно улучшит производительность (например, IntDataBuffer.setInt(idx)

Размер буфера в элементах.

Например, в случае байтового буфера это значение равно количеству байтов, которые может хранить этот буфер. Для целочисленного буфера оно равно количеству целых чисел, поэтому размер этого буфера в байтах равен size() * Integer.BYTES .

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

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

Создает DataBufferWindow , который обеспечивает частичное представление этого буфера.

Созданное окно имеет фиксированный размер и может "slide" по этому буферу, обеспечивая различные представления данных без выделения нового экземпляра буфера, как это делает offset(long) . Это повышает общую производительность при частом повторении этой операции. Например:

IntDataBuffer bufferA = DataBuffers.ofInts(1024);
 // ... init buffer data
 IntDataBuffer bufferB = DataBuffers.ofInts(1, 2, 3, 4);

 // Return the index of the first occurrence of bufferB in bufferA using a sliding window
 DataBufferWindow<IntDataBuffer> windowA = bufferA.window(4);
 for (int i = 0; i < bufferA.size() - bufferB.size(); ++i) {
     if (windowA.slideTo(i).buffer().equals(bufferB)) {
         return i;
     
 }
 }

Возвращенный объект имеет состояние и не является потокобезопасным.

Запишите ссылки на объекты исходного массива в этот буфер.

Этот метод передает значения из данного исходного массива в этот буфер. Если в исходном массиве больше значений, чем в этом буфере, то есть если src.length > size() , значения не передаются и создается исключение BufferOverflowException.

В противном случае этот метод копирует значения n = src.length из заданного массива.

Метод массового размещения с использованием массивов int.

Этот метод передает значения из данного исходного массива в этот буфер. Если в исходном массиве больше значений, чем в этом буфере, то есть если length > size() , значения не передаются и создается исключение BufferOverflowException.

В противном случае этот метод копирует значения n = length из заданного массива в этот буфер, начиная с заданного смещения.