Module  java.base
软件包  java.nio.channels

Class FileChannel

  • All Implemented Interfaces:
    Closeable ， AutoCloseable ， ByteChannel ， Channel ， GatheringByteChannel ， InterruptibleChannel ， ReadableByteChannel ， ScatteringByteChannel ， SeekableByteChannel ， WritableByteChannel 

    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方法返回通道的对象的状态密切相关。 更改频道的位置，无论是显式地还是通过读取或写入字节，都会改变原始对象的文件位置，反之亦然。 通过文件通道更改文件的长度将会改变通过始发对象所看到的长度，反之亦然。 通过写入字节来更改文件的内容将会改变原始对象所看到的内容，反之亦然。

    在这个类中，这个类指定一个“开放阅读”，“开放写作”或“开放阅读和写作”的实例是必需的。 通过270560335200836实例的getChannel方法获得的频道将被开放供阅读。 通过FileOutputStream实例的getChannel方法获得的通道将被开放供写入。 最后，通过所获得的信道getChannel一个的方法RandomAccessFile实例将是开放的，如果该实例用模式下创建阅读"r"和将开放阅读和如果该实例用模式下创建的写"rw" 。

    打开写入的文件通道可能处于附加模式 ，例如，如果是从通过调用FileOutputStream(File,boolean)构造函数创建的文件输出流获取并传递第二个参数的true 。 在该模式中，相对写入操作的每次调用首先将位置前进到文件的末尾，然后写入所请求的数据。 在单一原子操作中是否提升位置和写入数据是依赖于系统的，因此是未指定的。

    从以下版本开始：
    1.4
    另请参见：
    FileInputStream.getChannel() ， FileOutputStream.getChannel() ， RandomAccessFile.getChannel()

    • Nested Class Summary

      Nested Classes  
      Modifier and Type Class 描述
      static class  FileChannel.MapMode
      文件映射模式的类型安全枚举。

    • 构造方法摘要

      构造方法  
      Modifier Constructor 描述
      protected FileChannel​()
      初始化此类的新实例。

    • 构造方法详细信息

      • FileChannel

        protected FileChannel​()
        初始化此类的新实例。

    • 方法详细信息

      • open

        public static FileChannel open​(Path path,
                               Set<? extends OpenOption> options,
                               FileAttribute<?>... attrs)
                        throws IOException
        打开或创建文件，返回文件通道以访问该文件。

        options参数确定文件的打开方式。 READ和WRITE选项确定文件是否应打开以进行读取和/或写入。 如果数组中没有包含选项（或APPEND选项），则打开文件进行阅读。 默认情况下，文件开始时开始读写。

        除了READ和WRITE ，还可能存在以下选项：

        additional options Option Description APPEND If this option is present then the file is opened for writing and each invocation of the channel's write method first advances the position to the end of the file and then writes the requested data. Whether the advancement of the position and the writing of the data are done in a single atomic operation is system-dependent and therefore unspecified. This option may not be used in conjunction with the READ or TRUNCATE_EXISTING options. TRUNCATE_EXISTING If this option is present then the existing file is truncated to a size of 0 bytes. This option is ignored when the file is opened only for reading. CREATE_NEW If this option is present then a new file is created, failing if the file already exists. When creating a file the check for the existence of the file and the creation of the file if it does not exist is atomic with respect to other file system operations. This option is ignored when the file is opened only for reading. CREATE If this option is present then an existing file is opened if it exists, otherwise a new file is created. When creating a file the check for the existence of the file and the creation of the file if it does not exist is atomic with respect to other file system operations. This option is ignored if the CREATE_NEW option is also present or the file is opened only for reading. DELETE_ON_CLOSE When this option is present then the implementation makes a best effort attempt to delete the file when closed by the the close method. If the close method is not invoked then a best effort attempt is made to delete the file when the Java virtual machine terminates. SPARSE When creating a new file this option is a hint that the new file will be sparse. This option is ignored when not creating a new file. SYNC Requires that every update to the file's content or metadata be written synchronously to the underlying storage device. (see Synchronized I/O file integrity). DSYNC Requires that every update to the file's content be written synchronously to the underlying storage device. (see Synchronized I/O file integrity).

        实施还可以支持其他选项。

        attrs参数是文件file-attributes的可选数组，用于在创建文件时以原子方式进行设置。

        新的信道是通过调用创建newFileChannel上创建该提供商方法Path 。

        参数
        path - 打开或创建文件的路径
        options - 指定文件打开方式的选项
        attrs - 创建文件时以原子方式设置的文件属性的可选列表
        结果
        一个新的文件通道
        异常
        IllegalArgumentException - 如果集合包含无效的选项组合
        UnsupportedOperationException - 如果 path与不支持创建文件通道的提供程序相关联，或者指定了不支持的打开选项，或者数组包含创建文件时无法原子设置的属性
        IOException - 如果发生I / O错误
        SecurityException - 如果安装了一个安全管理器，并且它拒绝执行所需的未指定的权限。 在默认提供程序的情况下，如果打开文件进行阅读，则调用SecurityManager.checkRead(String)方法来检查读访问。 如果打开文件写入，则调用SecurityManager.checkWrite(String)方法来检查写访问
        从以下版本开始：
        1.7

      • open

        public static FileChannel open​(Path path,
                               OpenOption... options)
                        throws IOException
        打开或创建文件，返回文件通道以访问该文件。

        调用此方法的行为方式与调用完全相同 

          fc.open(file, opts, new FileAttribute<?>[0]);
        其中opts是options数组中指定的一组选项。
        参数
        path - 打开或创建文件的路径
        options - 指定文件打开方式的选项
        结果
        一个新的文件通道
        异常
        IllegalArgumentException - 如果集合包含无效的选项组合
        UnsupportedOperationException - 如果 path与不支持创建文件通道的提供程序相关联，或者指定了不支持的打开选项
        IOException - 如果发生I / O错误
        SecurityException - 如果安装了一个安全管理器，并且它拒绝了实现所需的未指定的许可。 在默认提供程序的情况下，如果打开文件进行读取，则调用SecurityManager.checkRead(String)方法来检查读访问。 如果打开文件写入，则调用SecurityManager.checkWrite(String)方法来检查写访问
        从以下版本开始：
        1.7

      • read

        public abstract int read​(ByteBuffer dst)
                  throws IOException
        从该通道读取到给定缓冲区的字节序列。

        从该通道的当前文件位置开始读取字节，然后以实际读取的字节数更新文件位置。 否则，此方法的行为与ReadableByteChannel界面中的规定完全相同。

        Specified by:
        read在接口 ReadableByteChannel
        Specified by:
        read在接口 SeekableByteChannel
        参数
        dst - 要传输字节的缓冲区
        结果
        读取的字节数，可能为零，如果通道已达到流出端， -1
        异常
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在读取操作正在进行中关闭此通道
        ClosedByInterruptException - 如果另一个线程在读取操作正在进行中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • read

        public abstract long read​(ByteBuffer[] dsts,
                          int offset,
                          int length)
                   throws IOException
        从该通道读取字节序列到给定缓冲区的子序列中。

        从该通道的当前文件位置开始读取字节，然后以实际读取的字节数更新文件位置。 否则，此方法的行为与ScatteringByteChannel界面中的规定完全相同。

        Specified by:
        read在接口 ScatteringByteChannel
        参数
        dsts - 要传输字节的缓冲区
        offset - 要传输字节的第一个缓冲区的缓冲区中的偏移量; 必须是非负数，不得大于dsts.length
        length - 要访问的缓冲区的最大数量; 必须是非负数，不得大于dsts.length - offset
        结果
        读取的字节数，可能为零，如果通道已达到流出尾， -1
        异常
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在读取操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在读取操作正在进行中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • read

        public final long read​(ByteBuffer[] dsts)
                throws IOException
        从该通道读取到给定缓冲区的字节序列。

        从该通道的当前文件位置开始读取字节，然后以实际读取的字节数更新文件位置。 否则，此方法的行为与ScatteringByteChannel界面中的规定完全相同。

        Specified by:
        read在接口 ScatteringByteChannel
        参数
        dsts - 要传输字节的缓冲区
        结果
        读取的字节数，可能为零，如果通道已达到流出端， -1
        异常
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在读取操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在读取操作正在进行中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • write

        public abstract int write​(ByteBuffer src)
                   throws IOException
        从给定的缓冲区向该通道写入一个字节序列。

        字节从该通道的当前文件位置开始写入，除非通道处于附加模式，在这种情况下，位置首先提前到文件的末尾。 如果需要，文件生长以容纳写入的字节，然后文件位置用实际写入的字节数更新。 否则，此方法的行为与WritableByteChannel接口的规定完全相同。

        Specified by:
        write在接口 SeekableByteChannel
        Specified by:
        write在接口 WritableByteChannel
        参数
        src - 要检索字节的缓冲区
        结果
        写入的字节数，可能为零
        异常
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在写操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • write

        public abstract long write​(ByteBuffer[] srcs,
                           int offset,
                           int length)
                    throws IOException
        从给定缓冲区的子序列将一个字节序列写入该通道。

        字节从该通道的当前文件位置开始写入，除非通道处于附加模式，在这种情况下，位置首先提前到文件的末尾。 如果需要，文件生长以容纳写入的字节，然后文件位置用实际写入的字节数更新。 否则，此方法的行为与GatheringByteChannel接口中的规定完全相同。

        Specified by:
        write在接口 GatheringByteChannel
        参数
        srcs - 要检索字节的缓冲区
        offset - 要检索字节的第一个缓冲区的缓冲区数组中的偏移量; 必须是非负数，不得大于srcs.length
        length - 要访问的缓冲区的最大数量; 必须是非负数，不得大于srcs.length - offset
        结果
        写入的字节数，可能为零
        异常
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在写操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • write

        public final long write​(ByteBuffer[] srcs)
                 throws IOException
        从给定的缓冲区向该通道写入一系列字节。

        字节从该通道的当前文件位置开始写入，除非通道处于附加模式，在这种情况下，位置首先提前到文件的末尾。 如果需要，文件生长以容纳写入的字节，然后文件位置用实际写入的字节数更新。 否则，此方法的行为与GatheringByteChannel界面中的规定完全相同。

        Specified by:
        write在接口 GatheringByteChannel
        参数
        srcs - 要检索字节的缓冲区
        结果
        写入的字节数，可能为零
        异常
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在写操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • position

        public abstract FileChannel position​(long newPosition)
                              throws IOException
        设置此通道的文件位置。

        将位置设置为大于文件当前大小的值是合法的，但不会更改文件的大小。 稍后在这样的位置读取字节的尝试将立即返回文件结束指示。 稍后在这样的位置写入字节的尝试将导致文件生长以适应新的字节; 未指定上一个文件结尾和新写入的字节之间的任何字节的值。

        Specified by:
        position在接口 SeekableByteChannel
        参数
        newPosition - 新位置，从文件开头计数字节数的非负整数
        结果
        此文件通道
        异常
        ClosedChannelException - 如果此通道关闭
        IllegalArgumentException - 如果新位置为负
        IOException - 如果发生其他I / O错误

      • truncate

        public abstract FileChannel truncate​(long size)
                              throws IOException
        将此频道的文件截断为给定大小。

        如果给定的大小小于文件的当前大小，则文件将被截断，丢弃超出文件新端的任何字节。 如果给定的大小大于或等于文件的当前大小，则该文件不会被修改。 在任一种情况下，如果此通道的文件位置大于给定的大小，则将其设置为该大小。

        Specified by:
        truncate在接口 SeekableByteChannel
        参数
        size - 新的大小，非负字节数
        结果
        此文件通道
        异常
        NonWritableChannelException - 如果此通道未打开以进行写入
        ClosedChannelException - 如果此通道关闭
        IllegalArgumentException - 如果新的大小为负数
        IOException - 如果发生其他I / O错误

      • force

        public abstract void force​(boolean metaData)
                    throws IOException
        强制将此通道文件的任何更新写入包含该通道的存储设备。

        如果此通道的文件驻留在本地存储设备上，那么当该方法返回时，保证自创建该通道以来创建或自从上次调用该方法以来对文件所做的所有更改都将写入该设备。 这对于确保系统崩溃时不会丢失关键信息非常有用。

        如果文件不在本地设备上，则不会提供此类保证。

        metaData参数可用于限制此方法执行所需的I / O操作数。 传递此参数的false表示仅对文件内容的更新需要写入存储; 通过true表示必须写入文件的内容和元数据的更新，通常需要至少一个I / O操作。 该参数实际上是否具有任何效果取决于底层操作系统，因此未指定。

        调用此方法可能会导致I / O操作发生，即使通道仅打开读取。 例如，某些操作系统将最后访问时间作为文件的元数据的一部分进行维护，并且每次读取文件时都会更新此时间。 这是否实际上是系统依赖的，因此是未指定的。

        此方法只能通过此类中定义的方法强制对此通道文件进行的更改。 它可能或不会强制通过修改通过调用map方法获得的mapped byte buffer的内容而进行的更改。 调用映射字节缓冲区的force方法将强制对缓冲区内容进行写入。

        参数
        metaData - 如果是true则需要这种方法强制更改文件的内容和元数据以写入存储; 否则，它只需要强制更改内容
        异常
        ClosedChannelException - 如果此通道关闭
        IOException - 如果发生其他I / O错误

      • transferTo

        public abstract long transferTo​(long position,
                                long count,
                                WritableByteChannel target)
                         throws IOException
        将该通道文件的字节传输到给定的可写字节通道。

        尝试从该通道的文件中给定的position开始读取最多count个字节，并将其写入目标通道。 此方法的调用可能会传送或不传送所有请求的字节; 是否这样做取决于渠道的性质和状态。 如果该通道的文件从给定的position开始包含少于count个字节，或者如果目标通道不阻塞，并且其输出缓冲区中的字节数少于count个字节，则传输的字节数少于所请求的字节数。

        此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，则不会传输任何字节。 如果目标通道具有位置，则从该位置开始写入字节，然后将该位置递增写入的字节数。

        该方法比从该通道读取并写入目标通道的简单循环更有效。 许多操作系统可以将字节直接从文件系统缓存传输到目标通道，而无需实际复制它们。

        参数
        position - 传输开始的文件中的位置; 必须是非负的
        count - 要传输的最大字节数; 必须是非负的
        target - 目标频道
        结果
        实际传输的字节数，可能为零
        异常
        IllegalArgumentException - 如果参数的前提条件不成立
        NonReadableChannelException - 如果此频道未打开阅读
        NonWritableChannelException - 如果目标通道未打开以进行写入
        ClosedChannelException - 如果此通道或目标通道关闭
        AsynchronousCloseException - 如果另一个线程在传输进行过程中关闭任一通道
        ClosedByInterruptException - 如果另一个线程在传输过程中中断当前线程，从而关闭两个通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • transferFrom

        public abstract long transferFrom​(ReadableByteChannel src,
                                  long position,
                                  long count)
                           throws IOException
        从给定的可读字节通道将字节传输到该通道的文件中。

        尝试从源通道读取最多count个字节，并将其写入此通道的文件，从给定的position 。 此方法的调用可能会传送或不传送所有请求的字节; 是否这样做取决于渠道的性质和状态。 如果源通道剩余少于count个字节，或者源通道不阻塞，并且其输入缓冲区中可立即可用的字节少于count字节， count少于所count字节数。

        此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，则不会传输任何字节。 如果源通道具有位置，则从该位置开始读取字节，然后将该位置递增读取的字节数。

        该方法比从源通道读取并写入此通道的简单循环可能更有效。 许多操作系统可以将字节直接从源通道传输到文件系统高速缓存中，而无需实际复制它们。

        参数
        src - 源频道
        position - 文件中要进行传输的位置; 必须是非负的
        count - 要传输的最大字节数; 必须是非负的
        结果
        实际传输的字节数，可能为零
        异常
        IllegalArgumentException - 如果参数的前提条件不成立
        NonReadableChannelException - 如果源通道未打开读取
        NonWritableChannelException - 如果这个频道没有开放写作
        ClosedChannelException - 如果此通道或源通道关闭
        AsynchronousCloseException - 如果另一个线程在传输过程中关闭任一通道
        ClosedByInterruptException - 如果另一个线程在传输过程中中断当前线程，从而关闭两个通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • read

        public abstract int read​(ByteBuffer dst,
                         long position)
                  throws IOException
        从给定的文件位置开始，从该通道读取一个字节序列到给定的缓冲区。

        该方法的工作原理与read(ByteBuffer)方法相同，只是从给定文件位置而不是在通道的当前位置读取字节。 此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，则不会读取任何字节。

        参数
        dst - 要传输字节的缓冲区
        position - 要开始传输的文件位置; 必须是非负的
        结果
        读取的字节数，可能为零，如果给定的位置大于或等于文件的当前大小， -1
        异常
        IllegalArgumentException - 如果位置为负
        NonReadableChannelException - 如果此频道未打开阅读
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在读取操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在读取操作正在进行中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • write

        public abstract int write​(ByteBuffer src,
                          long position)
                   throws IOException
        从给定的缓冲区向给定的文件位置开始，向该通道写入一个字节序列。

        该方法的工作方式与write(ByteBuffer)方法相同，只是字节从给定的文件位置而不是在通道的当前位置写入。 此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，那么该文件将被生长以适应新的字节; 未指定上一个文件结尾和新写入的字节之间的任何字节的值。

        参数
        src - 要传输字节的缓冲区
        position - 传输开始的文件位置; 必须是非负的
        结果
        写入的字节数，可能为零
        异常
        IllegalArgumentException - 如果位置为负
        NonWritableChannelException - 如果这个频道没有开放写作
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在写操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他I / O错误

      • map

        public abstract MappedByteBuffer map​(FileChannel.MapMode mode,
                                     long position,
                                     long size)
                              throws IOException
        将此频道文件的区域直接映射到内存中。

        文件的区域可以以三种模式之一映射到存储器中：

        • 只读：任何尝试修改生成的缓冲区将导致抛出ReadOnlyBufferException 。 （ MapMode.READ_ONLY ）

        • 读/写：对结果缓冲区所做的更改将最终传播到文件中; 它们可能也可能不会被映射到同一文件的其他程序可见。 （ MapMode.READ_WRITE ）

        • 私有：对结果缓冲区所做的更改不会传播到该文件，并且对于映射了相同文件的其他程序将不可见; 相反，它们将导致要创建的缓冲区的修改部分的私有副本。 （ MapMode.PRIVATE ）

        对于只读映射，此通道必须已打开才能读取; 对于读/写或私有映射，此通道必须已打开以供读写。

        该方法返回的mapped byte buffer的位置为零，容量为size ; 它的标记将是未定义的。 缓冲区及其表示的映射将保持有效，直到缓冲区本身被垃圾回收为止。

        映射一旦建立，就不依赖于用于创建它的文件通道。 关闭通道，特别是对映射的有效性没有影响。

        内存映射文件的许多细节固有地依赖于底层操作系统，因此是未指定的。 当请求的区域未完全包含在该通道的文件中时，此方法的行为是未指定的。 对该程序或另一个的底层文件的内容或大小进行的更改是否被传播到缓冲区是未指定的。 缓冲区的更改传播到文件的速率是未指定的。

        对于大多数操作系统，将文件映射到内存中比通过通常的read和write方法读取或写入几十千字节的数据更昂贵。 从性能的角度来看，通常只能将较大的文件映射到内存中。

        参数
        mode -一个常量READ_ONLY ， READ_WRITE ，或PRIVATE在所定义FileChannel.MapMode类，根据该文件是否是要被映射的只读，读/写，或私人（写入时复制），分别
        position - 映射区域要启动的文件中的位置; 必须是非负的
        size - 要映射的区域的大小; 必须是非负数，不得大于Integer.MAX_VALUE
        结果
        映射的字节缓冲区
        异常
        NonReadableChannelException - 如果 mode是 READ_ONLY，但这个频道没有打开阅读
        NonWritableChannelException - 如果 mode是 READ_WRITE或 PRIVATE，但这个频道没有打开读写
        IllegalArgumentException - 如果参数的前提条件不成立
        IOException - 如果发生其他I / O错误
        另请参见：
        FileChannel.MapMode ， MappedByteBuffer

      • lock

        public abstract FileLock lock​(long position,
                              long size,
                              boolean shared)
                       throws IOException
        获取此通道文件的给定区域的锁定。

        此方法的调用将阻塞，直到该区域被锁定，此通道关闭或调用的线程被中断（以先到者为准）。

        如果此通道在调用此方法时由另一个线程关闭，那么将抛出一个AsynchronousCloseException 。

        如果调用线程在等待获取锁定时中断，则其中断状态将被设置， 并且将抛出一个FileLockInterruptionException 。 如果在调用此方法时调用了调用者的中断状态，那么将立即抛出该异常; 线程的中断状态不会改变。

        由position和size参数指定的区域不需要包含在实际的底层文件内，甚至与其重叠。 锁定区域的大小固定; 如果锁定区域最初包含文件的结尾，并且文件增长超出该区域，那么该文件的新部分将不会被该锁覆盖。 如果文件的大小增加，并且整个文件都需要锁定，则应该锁定从零开始并且不小于文件的预期最大大小的区域。 零参数lock()方法简单地锁定一个大小为Long.MAX_VALUE的区域。

        某些操作系统不支持共享锁，在这种情况下，共享锁的请求将自动转换为独占锁的请求。 新获取的锁是共享的还是独占的都可以通过调用生成的锁对象的isShared方法进行测试。

        文件锁代表整个Java虚拟机。 它们不适用于通过同一虚拟机中的多个线程控制对文件的访问。

        参数
        position - 锁定区域要启动的位置; 必须是非负的
        size - 锁定区域的大小; 必须是非负数，并且position + size的总和必须是非负数
        shared - true以请求共享锁，在这种情况下，该通道必须打开才能读取（可能写入）; false要求排他锁，在这种情况下，此通道必须打开以进行写入（可能读取）
        结果
        表示新获取的锁的锁定对象
        异常
        IllegalArgumentException - 如果参数的前提条件不成立
        ClosedChannelException - 如果此通道关闭
        AsynchronousCloseException - 如果另一个线程在此方法中阻止调用线程时关闭此通道
        FileLockInterruptionException - 如果调用线程在此方法中被阻止时中断
        OverlappingFileLockException - 如果与该请求区域重叠的锁已由该Java虚拟机保存，或者该方法中是否已阻止另一个线程，并尝试锁定重叠区域
        NonReadableChannelException - 如果 shared是 true这个频道没有打开阅读
        NonWritableChannelException - 如果 shared是 false但这个频道没有开放写作
        IOException - 如果发生其他I / O错误
        另请参见：
        lock() ， tryLock() ， tryLock(long,long,boolean)

      • tryLock

        public abstract FileLock tryLock​(long position,
                                 long size,
                                 boolean shared)
                          throws IOException
        尝试获取此通道文件的给定区域的锁定。

        此方法不阻止。 调用总是立即返回，要么获取了请求的区域的锁定，要么没有这样做。 如果由于重叠的锁被另一个程序持有而无法获取锁定，则它将返回null 。 如果由于任何其他原因无法获取锁，则抛出适当的异常。

        由position和size参数指定的区域不需要包含在实际底层文件内，甚至与实际的底层文件重叠。 锁定区域的大小固定; 如果锁定区域最初包含文件的结尾，并且文件增长超出该区域，那么该文件的新部分将不会被该锁覆盖。 如果文件的大小增加，并且整个文件都需要锁定，则应该锁定从零开始并且不小于文件的预期最大大小的区域。 零参数tryLock()方法简单地锁定大小为Long.MAX_VALUE的区域。

        某些操作系统不支持共享锁，在这种情况下，共享锁的请求将自动转换为独占锁的请求。 新获取的锁是共享的还是独占的都可以通过调用生成的锁对象的isShared方法进行测试。

        文件锁代表整个Java虚拟机。 它们不适用于通过同一虚拟机中的多个线程控制对文件的访问。

        参数
        position - 锁定区域要启动的位置; 必须是非负的
        size - 锁定区域的大小; 必须是非负数，并且position + size必须为非负数
        shared - true要求共享锁， false要求排他锁
        结果
        表示新获取的锁的锁定对象，如果由于另一个程序持有重叠的锁而无法获取锁， null
        异常
        IllegalArgumentException - 如果参数的前提条件不成立
        ClosedChannelException - 如果此通道关闭
        OverlappingFileLockException - 如果与该请求区域重叠的锁已由该Java虚拟机保存，或者该方法中已阻止另一个线程，并尝试锁定同一文件的重叠区域
        IOException - 如果发生其他I / O错误
        另请参见：
        lock() ， lock(long,long,boolean) ， tryLock()