JavaTM 2 Platform
Standard Ed. 5.0

java.nio.channels
类 FileLock

java.lang.Object
  继承者 java.nio.channels.FileLock

public abstract class FileLock
extends Object

表示文件区域锁定的标记。

每次通过 FileChannel 类的 locktryLock 方法获取文件上的锁定时,就会创建一个文件锁定对象。

文件锁定对象最初是有效的。通过调用 release 方法、关闭用于获取该锁定的通道,或者终止 Java 虚拟机(以先到者为准)来释放锁定之前,该对象一直是有效的。可通过调用锁定的 isValid 方法来测试锁定的有效性。

文件锁定要么是独占的,要么是共享的。共享锁定可阻止其他并发运行的程序获取重叠的独占锁定,但是允许该程序获取重叠的共享锁定。独占锁定则阻止其他程序获取任一类型的重叠锁定。一旦释放某个锁定后,它就不会再对其他程序所获取的锁定产生任何影响。

可通过调用某个锁定的 isShared 方法来确定它是独占的还是共享的。某些平台不支持共享锁定,在这种情况下,对共享锁定的请求被自动转换为对独占锁定的请求。

单个 Java 虚拟机在某个特定文件上所保持的锁定是不重叠的。要测试某个候选锁定范围是否与现有锁定重叠,可使用 overlaps 方法。

文件锁定对象记录了在其文件上保持锁定的文件通道、该锁定的类型和有效性,以及锁定区域的位置和大小。只有锁定的有效性是随时间而更改的;锁定状态的所有其他方面都是不可变的。

文件锁定以整个 Java 虚拟机来保持。但它们不适用于控制同一虚拟机内多个线程对文件的访问。

多个并发线程可安全地使用文件锁定对象。

平台依赖性

此文件锁定 API 直接映射到基础操作系统的本机锁定设施。因此,无论程序是用何种语言编写的,某个文件上所保持的锁定对于所有访问该文件的程序来说都应该是可见的。

某个锁定是否实际阻止另一个程序访问该锁定区域的内容是与系统相关的,因此是未指定的。有些系统的本机文件锁定设施只是劝告的,意味着为了保证数据的完整性,各个程序必须遵守已知的锁定协议。其他系统本机文件锁定是强制的,意味着如果某个程序锁定了某个文件区域,则实际上阻止其他程序以违反该锁定的方式访问该区域。但在其他系统上,本机文件锁定是劝告的还是强制的可以以每个文件为基础进行配置。为确保平台间的一致性和正确性,强烈建议将此 API 提供的锁定作为劝告锁定来使用。

在有些系统上,在某个文件区域上获取强制锁定会阻止该区域被 java.nio.channels.FileChannel#map映射到内存,反之亦然。组合锁定和映射的程序应该为此组合的失败做好准备。

在有些系统上,关闭某个通道会释放 Java 虚拟机在基础文件上所保持的所有锁定,而不管该锁定是通过该通道获取的,还是通过同一文件上打开的另一个通道获取的。强烈建议在某个程序内使用惟一的通道来获取任意给定文件上的所有锁定。

有些网络文件系统仅在锁定区域是页对齐的并且是多个基础硬件的总的页大小时,才允许文件锁定与内存映射文件一起使用。有些网络文件系统不对扩展超出某个位置(通常是 230 或 231)的区域实现文件锁定。通常,对驻留在网络文件系统上的文件进行锁定时应该极其小心。

从以下版本开始:
1.4

构造方法摘要
protected FileLock(FileChannel channel, long position, long size, boolean shared)
          初始化此类的一个新实例。
 
方法摘要
 FileChannel channel()
          返回文件通道,此锁定保持在该通道的文件上。
 boolean isShared()
          判断此锁定是否为共享的。
abstract  boolean isValid()
          判断此锁定是否有效。
 boolean overlaps(long position, long size)
          判断此锁定是否与给定的锁定区域重叠。
 long position()
          返回文件内锁定区域中第一个字节的位置。
abstract  void release()
          释放此锁定。
 long size()
          返回锁定区域的大小,以字节为单位。
 String toString()
          返回描述此锁定的范围、类型和有效性的字符串。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

FileLock

protected FileLock(FileChannel channel,
                   long position,
                   long size,
                   boolean shared)
初始化此类的一个新实例。

参数:
channel - 文件通道,此锁定保持在该通道的文件上
position - 文件中的位置,锁定区域从此位置开始;必须为非负数
size - 锁定区域的大小;必须为非负数,并且 position + size 的和必须为非负数
shared - 如果此锁定是共享的,则为 true,如果是独占的,则为 false
抛出:
IllegalArgumentException - 如果关于参数的前提不成立
方法详细信息

channel

public final FileChannel channel()
返回文件通道,此锁定保持在该通道的文件上。

返回:
文件通道

position

public final long position()
返回文件内锁定区域中第一个字节的位置。

锁定区域不必包含在实际的基础文件中,甚至不必与其重叠,所以此方法返回的值可能超出文件的当前大小。

返回:
位置

size

public final long size()
返回锁定区域的大小,以字节为单位。

锁定区域不必包含在实际的基础文件中,甚至不必与其重叠,所以此方法返回的值可能超出文件的当前大小。

返回:
锁定区域的大小

isShared

public final boolean isShared()
判断此锁定是否为共享的。

返回:
如果是共享的,则返回 true,如果是独占的,则返回 false

overlaps

public final boolean overlaps(long position,
                              long size)
判断此锁定是否与给定的锁定区域重叠。

返回:
当且仅当此锁定与给定的锁定区域至少重叠一个字节时才返回 true

isValid

public abstract boolean isValid()
判断此锁定是否有效。

在释放锁定对象或关闭与其关联的文件通道(以先到者为准)之前,该锁定对象保持有效。

返回:
当且仅当此锁定为有效时才返回 true

release

public abstract void release()
                      throws IOException
释放此锁定。

如果此锁定对象是有效的,则调用此方法会释放该锁定并使该对象无效。如果此锁定对象是无效的,则调用此方法无效。

抛出:
ClosedChannelException - 如果用于获取此锁定的通道不再处于打开状态
IOException - 如果发生 I/O 错误

toString

public final String toString()
返回描述此锁定的范围、类型和有效性的字符串。

覆盖:
Object 中的 toString
返回:
一个描述性的字符串

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策