Класс FileChannel

public abstract class FileChannel
extends AbstractInterruptibleChannel
implements SeekableByteChannel, GatheringByteChannel, ScatteringByteChannel

Канал для чтения, записи, отображения и управления файлом.

Файловый канал — это SeekableByteChannel, подключенный к файлу. Он имеет текущую позицию в файле, которую можно как queried, так и modified. Сам файл содержит последовательность байтов переменной длины, которые можно читать и записывать, и чью текущую size можно запросить. Размер файла увеличивается, когда записываются байты за пределами текущего размера; размер файла уменьшается при truncated. Файл также может иметь некоторую связанную метаданные, такие как разрешения на доступ, тип содержимого и время последней модификации; методы доступа к метаданным не определены в этом классе.

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

• Байты могут быть read или written по абсолютному положению в файле таким образом, что это не влияет на текущую позицию канала.

• Область файла может быть mapped непосредственно в память; для больших файлов это часто намного эффективнее, чем вызов обычных read или write методов.

• Внесенные изменения в файл могут быть forced out на устройство хранения, обеспечивая, что данные не будут потеряны в случае сбоя системы.

• Байты могут быть переданы из файла to some other channel и vice versa таким образом, что многие операционные системы могут оптимизировать это в очень быстрое прямое перемещение в кэш файловой системы.

• Область файла может быть locked от доступа другими программами.

Файловые каналы безопасны для использования несколькими потоками одновременно. Метод close может быть вызван в любое время, как указано в интерфейсе Channel. Только одна операция, которая включает позицию канала или может изменить размер файла, может быть выполнена в данный момент; попытки инициировать вторую такую операцию, пока первая еще выполняется, будут заблокированы до завершения первой операции. Другие операции, в частности те, которые принимают явную позицию, могут выполняться одновременно; зависит от реализации и поэтому не определено.

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

Файловый канал создается путем вызова одного из методов open, определенных этим классом. Файловый канал также можно получить из существующего FileInputStream, FileOutputStream или RandomAccessFile объекта, вызвав метод объекта getChannel, который возвращает файловый канал, подключенный к тому же базовому файлу. Если файловый канал получен из существующего потока или файла случайного доступа, то состояние файлового канала тесно связано с состоянием объекта, чей метод getChannel вернул канал. Изменение позиции канала, явным образом или путем чтения или записи байтов, изменит позицию файла исходного объекта, и наоборот. Изменение длины файла через файловый канал изменит длину, видимую через исходный объект, и наоборот. Изменение содержимого файла путем записи байтов изменит содержимое, видимое исходным объектом, и наоборот.

В различных местах в этом классе указывается, что требуется экземпляр, который «открыт для чтения», «открыт для записи» или «открыт для чтения и записи». Канал, полученный с помощью метода getChannel экземпляра FileInputStream, будет открыт для чтения. Канал, полученный с помощью метода getChannel экземпляра FileOutputStream, будет открыт для записи. Наконец, канал, полученный с помощью метода getChannel экземпляра RandomAccessFile, будет открыт для чтения, если экземпляр был создан в режиме "r", и будет открыт для чтения и записи, если экземпляр был создан в режиме "rw".

Файловый канал, открытый для записи, может быть в режиме добавления, например, если он был получен из потока вывода файла, который был создан путем вызова конструктора FileOutputStream(File,boolean) и передачи true в качестве второго параметра. В этом режиме каждый вызов относительной операции записи сначала перемещает позицию в конец файла, а затем записывает запрашиваемые данные. Является ли продвижение позиции и запись данных единой атомарной операцией, зависит от системы и поэтому не определено.