Интерфейс MemorySegment

Возвращаемое разбиение разделяет этот сегмент в соответствии с указанной компоновкой элементов; то есть, если предоставленная компоновка имеет размер N, то вызов Spliterator.trySplit() приведет к разбиению, содержащему примерно S/N/2 элементов (в зависимости от того, является ли N чётным или нет), где S - размер этого сегмента. Таким образом, разбиение возможно, если S/N >= 2. Разбиение возвращает сегменты, которые имеют тот же объем, что и данный сегмент.

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

    StreamSupport.stream(segment.spliterator(elementLayout), false);
 

Эквивалентно следующему коду:

    asSlice(newBase.segmentOffset(this), newSize);
 

Эквивалентно следующему коду:

    asSlice(offset, byteSize() - offset);
 

Эквивалентно следующему коду:

    asSlice(newBase.segmentOffset(this));
 

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

byteHandle = MemoryLayout.ofSequence(MemoryLayouts.JAVA_BYTE)
         .varHandle(byte.class, MemoryLayout.PathElement.sequenceElement());
for (long l = 0; l < segment.byteSize(); l++) {
     byteHandle.set(segment.address(), l, value);
}
 

Заполнение может быть полезно для инициализации или сброса памяти сегмента.

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

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

Значение true подразумевает, что, скорее всего, все данные в этом сегменте находятся в физической памяти и могут быть, следовательно, обработаны без возникновения страниц виртуальной памяти или операций ввода-вывода. Значение false не обязательно означает, что содержимое этого сегмента не находится в физической памяти.

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

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

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

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

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

Если этот сегмент не был отображён в режиме чтения/записи (FileChannel.MapMode.READ_WRITE), то вызов этого метода может не иметь эффекта. В частности, метод не имеет эффекта для сегментов, отображённых в режимах только для чтения или частного отображения. Этот метод может или не может иметь эффект для режимов отображения, специфичных для реализации.

Позиция возвращаемого буфера (см. Buffer.position()) первоначально устанавливается в ноль, а ёмкость и предел возвращаемого буфера (см. Buffer.capacity() и Buffer.limit() соответственно) устанавливаются на размер этого сегмента (см. byteSize()). По этой причине буфер байтов не может быть возвращён, если размер этого сегмента больше Integer.MAX_VALUE.

Жизненный цикл возвращаемого буфера будет связан с жизненным циклом этого сегмента. То есть, доступ к возвращаемому буферу после закрытия области, связанной с этим сегментом (см. ResourceScope.close(), вызовет IllegalStateException.

Если этот сегмент связан с ограниченной областью, вызов операций ввода-вывода чтения/записи на результирующий буфер может привести к выбрасыванию неопределённого исключения. Примеры таких проблемных операций - AsynchronousSocketChannel.read(ByteBuffer) и AsynchronousSocketChannel.write(ByteBuffer).

Наконец, порядок байтов результирующего буфера - ByteOrder.BIG_ENDIAN; это можно изменить с помощью ByteBuffer.order(java.nio.ByteOrder).

Если буфер read-only, результирующий сегмент также будет read-only. Область, связанная с этим сегментом, может быть глобальной областью ресурсов global, если буфер был создан независимо, или какой-либо другой (возможно, закрываемой) областью ресурсов, если буфер был получен с помощью asByteBuffer().

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

Эквивалентно следующему коду:

    allocateNative(layout.bytesSize(), layout.bytesAlignment(), scope);
 

Блок внекучевой памяти, связанный с возвращаемым сегментом нативной памяти, инициализируется нулями.

Эквивалентно следующему коду:

    allocateNative(bytesSize, 1, scope);
 

Блок внекучевой памяти, связанный с возвращаемым сегментом нативной памяти, инициализируется нулями.

Блок памяти вне кучи, связанный с возвращённым сегментом нативной памяти, инициализируется нулями.

Если указанный режим отображения — READ_ONLY, то получившийся сегмент будет только для чтения (см. isReadOnly()).

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

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

    MemoryAddress.NULL.asSegment(Long.MAX_VALUE)
 

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