Класс MappedByteBuffer

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

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

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

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

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

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

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

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

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

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

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

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

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

После последовательности операций чтения канала или 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 при передаче данных из одного места в другое.

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

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

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

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

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

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

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

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

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

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

Байты между текущей позицией буфера и его пределом, если таковые имеются, копируются в начало буфера. То есть байт с индексом 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
    }