Класс 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
    }