java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策