Класс MappedByteBuffer

public final boolean isLoaded()

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

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

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

public final MappedByteBuffer load()

Загружает содержимое этого буфера в физическую память.

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

public final MappedByteBuffer force()

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

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

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

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

public final MappedByteBuffer force(int index, int length)

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

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

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

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

public final MappedByteBuffer position(int newPosition)

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

public final MappedByteBuffer limit(int newLimit)

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

public final MappedByteBuffer mark()

Устанавливает метку этого буфера в его позиции.

public final MappedByteBuffer reset()

Возвращает позицию этого буфера к ранее помеченной позиции.

Вызов этого метода не изменяет и не отбрасывает значение метки.

public final MappedByteBuffer clear()

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

Вызывайте этот метод перед использованием последовательности операций чтения канала или операций put для заполнения этого буфера. Например:

 buf.clear();     // Prepare buffer for reading
 in.read(buf);    // Read data

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

public final MappedByteBuffer flip()

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

После последовательности операций чтения канала или операций put вызовите этот метод, чтобы подготовиться к последовательности операций записи канала или относительных операций get. Например:

 buf.put(magic);    // Prepend header
 in.read(buf);      // Read data into rest of buffer
 buf.flip();        // Flip buffer
 out.write(buf);    // Write header + data to channel

Этот метод часто используется совместно с методом compact при передаче данных из одного места в другое.

public final MappedByteBuffer rewind()

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

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

 out.write(buf);    // Write remaining data
 buf.rewind();      // Rewind buffer
 buf.get(array);    // Copy data into array

public abstract MappedByteBuffer slice()

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

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

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

Чтение байтов в физическую память, вызывая load() на возвращаемом буфере, или запись байтов на устройство хранения, вызывая force() на возвращаемом буфере, будет действовать только на поддиапазон этого буфера, который представляет возвращаемый буфер, а именно [position(),limit()).

public abstract MappedByteBuffer slice(int index, int length)

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

Содержимое нового буфера начнётся с позиции index в этом буфере и будет содержать length элементов. Изменения в содержимом этого буфера будут видны в новом буфере, и наоборот; позиции, пределы и метки двух буферов будут независимы.

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

Чтение байтов в физическую память путём вызова load() для возвращённого буфера или запись байтов в устройство хранения путём вызова force() для возвращённого буфера будет действовать только на поддиапазон этого буфера, который представляет возвращённый буфер, а именно [index,index+length), где index и length предполагаются для удовлетворения предварительных условий.

public abstract MappedByteBuffer duplicate()

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

Содержимое нового буфера будет таким же, как у этого буфера. Изменения в содержимом этого буфера будут видны в новом буфере, и наоборот; позиции, пределы и метки двух буферов будут независимы.

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

public abstract MappedByteBuffer compact()

Уплотняет этот буфер (необязательная операция).

Байты между текущей позицией буфера и его пределом, если таковые имеются, копируются в начало буфера. То есть, байт с индексом p = position() копируется в индекс ноль, байт с индексом p + 1 копируется в индекс один, и так далее, пока байт с индексом limit() - 1 не будет скопирован в индекс n = limit() - 1 - p. Позиция буфера затем устанавливается в n+1, а его предел устанавливается в его ёмкость. Метка, если она определена, отбрасывается.

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

Вызовите этот метод после записи данных из буфера в случае, если запись была неполной. Например, следующий цикл копирует байты из одного канала в другой через буфер buf:

   buf.clear();          // Prepare buffer for use
   while (in.read(buf) >= 0 || buf.position != 0) {
       buf.flip();
       out.write(buf);
       buf.compact();    // In case of partial write
   }