Класс MappedByteBuffer

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

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

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

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

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

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

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

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

Если этот буфер не был сопоставлен в режиме чтения/записи (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
    }