Класс FileLock

public abstract class FileLock
extends Object
implements AutoCloseable

Токен, представляющий блокировку региона файла.

Объект блокировки файла создается каждый раз, когда блокировка приобретается на файле с помощью одного из методов lock или tryLock класса FileChannel, или методов lock или tryLock класса AsynchronousFileChannel.

Объект блокировки файла изначально действителен. Он остается действительным до тех пор, пока блокировка не будет освобождена вызовом метода release, путем закрытия канала, используемого для ее получения, или по завершении работы виртуальной машины Java, в зависимости от того, что наступит раньше. Действительность блокировки может быть проверена путем вызова метода isValid.

Блокировка файла может быть исключительной или совместной. Блокировка по совместному доступу предотвращает другие выполняющиеся одновременно программы от получения перекрывающейся исключительной блокировки, но позволяет им получать перекрывающиеся совместные блокировки. Исключительная блокировка предотвращает другие программы от получения перекрывающейся блокировки любого типа. После ее освобождения блокировка больше не оказывает никакого влияния на блокировки, которые могут быть получены другими программами.

Является ли блокировка исключительной или совместной, можно определить, вызвав метод isShared. Некоторые платформы не поддерживают совместные блокировки, в этом случае запрос на совместную блокировку автоматически преобразуется в запрос на исключительную блокировку.

Блокировки, удерживаемые на одном файле одной виртуальной машиной Java, не перекрываются. Метод overlaps можно использовать для проверки того, перекрывается ли диапазон кандидатской блокировки существующей блокировкой.

Объект блокировки файла записывает канал файла, на котором удерживается блокировка, тип и действительность блокировки, а также позицию и размер заблокированного региона. Только действительность блокировки может меняться со временем; все другие аспекты состояния блокировки неизменны.

Файловые блокировки удерживаются от имени всей виртуальной машины Java. Они не подходят для управления доступом к файлу несколькими потоками в одной виртуальной машине.

Объекты блокировок файлов безопасны для использования несколькими параллельными потоками.

Зависимости от платформы

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

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

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

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

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