compact1, compact2, compact3

java.nio.channels

Класс FileLock

java.lang. Объект

java.nio.channels. FileLock

Все Реализованные Интерфейсы:

AutoCloseable

public abstract class FileLock
extends Object
implements AutoCloseable

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

С тех пор:

1.4

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	FileLock(AsynchronousFileChannel channel, long position, long size, boolean shared) Инициализирует новый экземпляр этого class.
protected	FileLock(FileChannel channel, long position, long size, boolean shared) Инициализирует новый экземпляр этого class.

Сводка метода

Модификатор и Тип	Метод и Описание
Канал	acquiredBy() Возвращает канал, на файл которого была получена эта блокировка.
FileChannel	channel() Возвращает канал файла, на файл которого была получена эта блокировка.
void	close() Этот метод вызывает release() метод.
boolean	isShared() Говорит, совместно используется ли эта блокировка.
abstract boolean	isValid() Говорит, допустима ли эта блокировка.
boolean	overlaps(long position, long size) Говорит, перекрывает ли эта блокировка данный диапазон блокировки.
long	position() Возвращает позицию в пределах файла первого байта заблокированной области.
abstract void	release() Выпуски эта блокировка.
long	size() Возвращает размер заблокированной области в байтах.
Строка	toString() Возвращает строку, описывающую диапазон, введите, и законность этой блокировки.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Деталь конструктора

FileLock

protected FileLock(FileChannel channel,
                   long position,
                   long size,
                   boolean shared)

Инициализирует новый экземпляр этого class.

Параметры:

channel - Канал файла, на файл которого сохранена эта блокировка

position - Позиция в пределах файла, в котором запускается заблокированная область; должно быть неотрицательным

size - Размер заблокированной области; должно быть неотрицательным, и сумма position + , size должен быть неотрицательным

shared - true, если эта блокировка совместно используется, false, если это является монопольным

Броски:

IllegalArgumentException - Если предварительные условия на параметрах не содержат

FileLock

protected FileLock(AsynchronousFileChannel channel,
                   long position,
                   long size,
                   boolean shared)

Инициализирует новый экземпляр этого class.

Параметры:

channel - Канал, на файл которого сохранена эта блокировка

position - Позиция в пределах файла, в котором запускается заблокированная область; должно быть неотрицательным

size - Размер заблокированной области; должно быть неотрицательным, и сумма position + , size должен быть неотрицательным

shared - true, если эта блокировка совместно используется, false, если это является монопольным

Броски:

IllegalArgumentException - Если предварительные условия на параметрах не содержат

С тех пор:

1.7

Деталь метода

канал

public final FileChannel channel()

Возвращает канал файла, на файл которого была получена эта блокировка.

Этот метод был заменен acquiredBy метод.

Возвраты:

Канал файла, или null если блокировка файла не была получена каналом файла.

acquiredBy

public Channel acquiredBy()

Возвращает канал, на файл которого была получена эта блокировка.

Возвраты:

Канал, на файл которого была получена эта блокировка.

С тех пор:

1.7

позиция

public final long position()

Возвращает позицию в пределах файла первого байта заблокированной области.

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

Возвраты:

Позиция

размер

public final long size()

Возвращает размер заблокированной области в байтах.

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

Возвраты:

Размер заблокированной области

isShared

public final boolean isShared()

Говорит, совместно используется ли эта блокировка.

Возвраты:

true, если блокировка совместно используется, false, если это является монопольным

перекрытия

public final boolean overlaps(long position,
                              long size)

Говорит, перекрывает ли эта блокировка данный диапазон блокировки.

Возвраты:

true, если, и только если, эта блокировка и данная блокировка располагаются перекрытие по крайней мере на один байт

isValid

public abstract boolean isValid()

Говорит, допустима ли эта блокировка.

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

Возвраты:

true, если, и только если, эта блокировка допустима

выпуск

public abstract void release()
                      throws IOException

Выпуски эта блокировка.

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

Броски:

ClosedChannelException - Если канал, который использовался, чтобы получить эту блокировку, больше не открыт

IOException - Если ошибка ввода-вывода происходит

близко

public final void close()
                 throws IOException

Этот метод вызывает release() метод. Это было добавлено к class так, чтобы это могло использоваться в соединении с автоматической блочной конструкцией управления ресурсами.

Определенный:

close в интерфейсе AutoCloseable

Броски:

IOException

С тех пор:

1.7

toString

public final String toString()

Возвращает строку, описывающую диапазон, введите, и законность этой блокировки.

Переопределения:

toString в class Object

Возвраты:

Дескриптивная строка