本篇文章为你整理了FileChannel (Java Platform SE 8 )（）的详细内容，包含有 FileChannel (Java Platform SE 8 )，希望能帮助你了解 FileChannel (Java Platform SE 8 )。
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方法返回通道的对象的状态密切相关 。 更改频道的位置，无论是显式地还是通过读取或写入字节，都会改变原始对象的文件位置，反之亦然。 通过文件通道更改文件的长度将会改变通过始发对象所看到的长度，反之亦然。 通过写入字节来更改文件的内容将会改变原始对象所看到的内容，反之亦然。
在这个类中，这个类指定一个“开放阅读”，“开放写作”或“开放阅读和写作”的实例是必需的。 通过88417600971309实例的getChannel方法获得的频道将被开放供阅读。 通过FileOutputStream实例的getChannel方法获得的通道将开放供书写。 最后，通过所获得的信道getChannel一个的方法RandomAccessFile实例将是开放的，如果该实例用模式"r"创建和将开放阅读和如果该实例用模式"rw"创建写入读取。
即打开用于写入的文件的信道可以是在附加模式下 ，例如，如果它是从由调用创建的文件输出流获得FileOutputStream(File,boolean)构造和传递true用于第二参数。 在该模式中，相对写入操作的每次调用首先将位置前进到文件的末尾，然后写入所请求的数据。 在单一原子操作中是否提升位置和写入数据是依赖于系统的，因此是未指定的。
abstract void
force(booleanmetaData)
强制将此通道文件的任何更新写入包含该通道的存储设备。
abstract FileLock
lock(longposition, longsize, booleanshared)
获取此通道文件的给定区域的锁定。
abstract long
read(ByteBuffer[]dsts, intoffset, intlength)
从该通道读取字节序列到给定缓冲区的子序列中。
abstract int
read(ByteBufferdst, longposition)
从给定的文件位置开始，从该通道读取一个字节序列到给定的缓冲区。
abstract FileLock
tryLock(longposition, longsize, booleanshared)
尝试获取此通道文件的给定区域的锁定。
abstract long
write(ByteBuffer[]srcs, intoffset, intlength)
从给定缓冲区的子序列将一个字节序列写入该通道。
abstract int
write(ByteBuffersrc, longposition)
从给定的缓冲区向给定的文件位置开始，向该通道写入一个字节序列。
方法详细信息
open
public staticFileChannelopen(Pathpath,
Set ? extends OpenOption options,
FileAttribute ? ...attrs)
throws IOException
打开或创建文件，返回文件通道以访问该文件。
options参数确定文件的打开方式。 READ和WRITE选项确定文件是否应被打开用于读取和/或写入。 如果数组中没有包含选项（或APPEND选项），则打开文件进行阅读。 默认情况下，文件开始时开始读写。
除了READ和WRITE ，还可能存在以下选项：
Option Description APPEND If this option is present then the file is opened for writing and each invocation of the channels 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 files content or metadata be written synchronously to the underlying storage device. (see Synchronized I/O file integrity). DSYNC Requires that every update to the files content be written synchronously to the underlying storage device. (see Synchronized I/O file integrity).
UnsupportedOperationException -如果
path已与不支持创建文件信道，或不支持的打开选项提供商相关联的指定，或阵列包含可以在创建文件时不被原子地设置一个属性
ClosedByInterruptException - 如果另一个线程在读取操作正在中断当前线程，从而关闭通道并设置当前线程的中断状态
read
public abstractlongread(ByteBuffer[]dsts,
intoffset,
intlength)
throws IOException
从该通道读取字节序列到给定缓冲区的子序列中。
从该通道的当前文件位置开始读取字节，然后以实际读取的字节数更新文件位置。 否则，此方法的行为与ScatteringByteChannel接口中的规定完全相同。
offset - 要传输字节的第一个缓冲区的缓冲区数组内的偏移量;
必须是非负数，不得大于dsts.length
ClosedByInterruptException - 如果另一个线程在读取操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
ClosedByInterruptException - 如果另一个线程在读取操作正在进行中断当前线程，从而关闭通道并设置当前线程的中断状态
write
public abstractintwrite(ByteBuffersrc)
throws IOException
从给定的缓冲区向该通道写入一个字节序列。
字节从该通道的当前文件位置开始写入，除非通道处于附加模式，在这种情况下，位置首先提前到文件的末尾。 如果需要，文件生长以容纳写入的字节，然后文件位置用实际写入的字节数更新。 否则，此方法的行为与WritableByteChannel接口的规定完全相同。
ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
write
public abstractlongwrite(ByteBuffer[]srcs,
intoffset,
intlength)
throws IOException
从给定缓冲区的子序列将一个字节序列写入该通道。
字节从该通道的当前文件位置开始写入，除非通道处于附加模式，在这种情况下，位置首先提前到文件的末尾。 如果需要，文件生长以容纳写入的字节，然后文件位置用实际写入的字节数更新。 否则，此方法的行为与GatheringByteChannel界面中的规定完全相同。
offset - 要从中检索字节的第一个缓冲区的缓冲区数组中的偏移量;
必须是非负数，不得大于srcs.length
ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
write
public finallongwrite(ByteBuffer[]srcs)
throws IOException
从给定的缓冲区向该通道写入一系列字节。
字节从该通道的当前文件位置开始写入，除非通道处于附加模式，在这种情况下，位置首先提前到文件的末尾。 如果需要，文件生长以容纳写入的字节，然后文件位置用实际写入的字节数更新。 否则，此方法的行为与GatheringByteChannel接口中的规定完全相同。
ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
position
public abstractlongposition()
throws IOException
返回此频道的文件位置。
position
public abstractFileChannelposition(longnewPosition)
throws IOException
设置此通道的文件位置。
将位置设置为大于文件当前大小的值是合法的，但不会更改文件的大小。 稍后在这样的位置读取字节的尝试将立即返回文件结束指示。 稍后在这样的位置写入字节的尝试将导致文件生长以适应新的字节; 未指定上一个文件结尾和新写入的字节之间的任何字节的值。
size
public abstractlongsize()
throws IOException
返回此通道文件的当前大小。
truncate
public abstractFileChanneltruncate(longsize)
throws IOException
将此频道的文件截断为给定大小。
如果给定的大小小于文件的当前大小，则文件将被截断，丢弃超出文件新端的任何字节。 如果给定的大小大于或等于文件的当前大小，则该文件不会被修改。 在任一情况下，如果此通道的文件位置大于给定大小，则将其设置为该大小。
force
public abstractvoidforce(booleanmetaData)
throws IOException
强制将此通道文件的任何更新写入包含该通道的存储设备。
如果此通道的文件驻留在本地存储设备上，那么当该方法返回时，将保证自创建该通道以来创建的该文件所做的所有更改，或自上次调用该方法以来，都将写入该设备。 这对于确保系统崩溃时不会丢失关键信息非常有用。
如果文件不在本地设备上，则不会提供此类保证。
metaData参数可用于限制此方法执行所需的I / O操作数。 为此参数传入false表示只更新文件的内容需要被写入存储设备; 通过true表示必须写入文件的内容和元数据的更新，这通常需要至少一个I / O操作。 该参数实际上是否具有任何效果取决于底层操作系统，因此未指定。
调用此方法可能会导致I / O操作发生，即使通道仅打开读取。 例如，某些操作系统将最后访问时间作为文件的元数据的一部分进行维护，并且每次读取文件时都会更新此时间。 这是否实际上是系统依赖的，因此是未指定的。
此方法只能通过此类中定义的方法强制对此通道文件进行的更改。 它可以或可以不强制通过修改一个的内容所做的更改mapped byte buffer通过调用获得map方法。 调用映射字节缓冲区的force方法将强制对缓冲区内容的更改进行写入。
metaData - 如果true那么需要这种方法来强制更改文件的内容和要写入存储的元数据;
否则，它只需要强制更改内容
transferTo
public abstractlongtransferTo(longposition,
longcount,
WritableByteChanneltarget)
throws IOException
将该通道文件的字节传输到给定的可写字节通道。
尝试从该通道文件中的给定position开始读取最多count个字节，并将其写入目标通道。 此方法的调用可能会传送或不传送所有请求的字节; 是否这样做取决于渠道的性质和状态。 如果该通道的文件包含少于count个字节，从给定的position开始，或者如果目标通道是非阻塞的，并且在其输出缓冲区中有少于count个字节的空闲， 那么传输的字节数将少于所请求的字节数。
此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，则不会传输任何字节。 如果目标通道具有位置，则从该位置开始写入字节，然后将该位置递增写入的字节数。
该方法比从该通道读取并写入目标通道的简单循环更有效。 许多操作系统可以将字节直接从文件系统缓存传输到目标通道，而无需实际复制它们。
ClosedByInterruptException - 如果另一个线程在传输过程中中断当前线程，从而关闭两个通道并设置当前线程的中断状态
transferFrom
public abstractlongtransferFrom(ReadableByteChannelsrc,
longposition,
longcount)
throws IOException
从给定的可读字节通道将字节传输到该通道的文件中。
尝试从源通道读取count个字节，并将其写入此通道的文件，从给定的position开始。 此方法的调用可能会传送或不传送所有请求的字节; 是否这样做取决于渠道的性质和状态。 如果源通道剩余少于count个字节，或者源通道为非阻塞，并且其输入缓冲区中立即可用的字节少于8841760419806字节，则将少于所请求的字节数。
此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，则不会传输任何字节。 如果源通道具有位置，则从该位置开始读取字节，然后将该位置递增读取的字节数。
该方法比从源通道读取并写入此通道的简单循环可能更有效。 许多操作系统可以将字节直接从源通道传输到文件系统高速缓存中，而无需实际复制它们。
ClosedByInterruptException - 如果另一个线程在传输过程中中断当前线程，从而关闭两个通道并设置当前线程的中断状态
read
public abstractintread(ByteBufferdst,
longposition)
throws IOException
从给定的文件位置开始，从该通道读取一个字节序列到给定的缓冲区。
该方法的工作原理与read(ByteBuffer)方法相同，只是从给定文件位置而不是在通道的当前位置开始读取字节。 此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，则不会读取任何字节。
ClosedByInterruptException - 如果另一个线程在读取操作正在进行中断当前线程，从而关闭通道并设置当前线程的中断状态
write
public abstractintwrite(ByteBuffersrc,
longposition)
throws IOException
从给定的缓冲区向给定的文件位置开始，向该通道写入一个字节序列。
该方法的工作方式与write(ByteBuffer)方法相同，只是字节从给定的文件位置而不是在通道的当前位置写入。 此方法不会修改此频道的位置。 如果给定的位置大于文件的当前大小，那么该文件将被生长以适应新的字节; 未指定上一个文件结尾和新写入的字节之间的任何字节的值。
ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
map
public abstractMappedByteBuffermap(FileChannel.MapModemode,
longposition,
longsize)
throws IOException
将此频道文件的区域直接映射到内存中。
文件的区域可以以三种模式之一映射到存储器中：
只读：任何尝试修改生成的缓冲区将导致抛出ReadOnlyBufferException 。 （ MapMode.READ_ONLY ）
读/写：对结果缓冲区所做的更改将最终传播到文件中; 它们可能也可能不会被映射到同一文件的其他程序可见。 （ MapMode.READ_WRITE ）
私有：对结果缓冲区所做的更改不会传播到该文件，并且对于映射了相同文件的其他程序将不可见; 相反，它们将导致要创建的缓冲区的修改部分的私有副本。 （ MapMode.PRIVATE ）
对于只读映射，此通道必须已打开才能读取; 对于读/写或私有映射，此通道必须已被打开以供读写。
该方法返回的mapped byte buffer的位置为零，容量为size ; 它的标记将是未定义的。 缓冲区及其表示的映射将保持有效，直到缓冲区本身被垃圾回收为止。
映射一旦建立，就不依赖于用于创建它的文件通道。 关闭通道，特别是对映射的有效性没有影响。
内存映射文件的许多细节固有地依赖于底层操作系统，因此是未指定的。 当请求的区域未完全包含在该通道的文件中时，此方法的行为是未指定的。 对该程序或另一个的底层文件的内容或大小进行的更改是否被传播到缓冲区是未指定的。 缓冲区的更改传播到文件的速率是未指定的。
对于大多数操作系统，将文件映射到内存中比通过通常的read和write方法读取或写入几十千字节的数据更 昂贵 。 从性能的角度来看，通常只能将较大的文件映射到内存中。
lock
public abstractFileLocklock(longposition,
longsize,
booleanshared)
throws IOException
获取此通道文件的给定区域的锁定。
此方法的调用将阻塞，直到该区域被锁定，此通道关闭或调用的线程被中断（以先到者为准）。
如果此通道在调用此方法期间由另一个线程关闭，则将抛出AsynchronousCloseException 。
如果在等待获取锁定的情况下调用线程中断，则其中断状态将被设置，并且将抛出一个FileLockInterruptionException 。 如果在调用此方法时调用了调用者的中断状态，那么将立即抛出该异常; 线程的中断状态不会改变。
由position和size参数指定的区域不需要包含在实际的底层文件内，甚至与实际的底层文件重叠。 锁定区域的大小固定; 如果锁定区域最初包含文件的结尾，并且文件增长超出该区域，那么该文件的新部分将不会被该锁覆盖。 如果文件的大小增加，并且整个文件都需要锁定，则应该锁定从零开始并且不小于文件的预期最大大小的区域。 零参数lock()方法简单地锁定一个大小为Long.MAX_VALUE的区域。
某些操作系统不支持共享锁，在这种情况下，共享锁的请求将自动转换为独占锁的请求。 新获取的锁是共享的还是独占的可以通过调用生成的锁定对象的isShared方法来测试。
文件锁代表整个Java虚拟机。 它们不适用于通过同一虚拟机中的多个线程来控制对文件的访问。
shared - true请求共享锁，在这种情况下，该通道必须打开才能读取（可能写入）;
false要求一个独占锁，在这种情况下，这个通道必须是开放的写（和可能阅读）
OverlappingFileLockException - 如果与该请求区域重叠的锁已由该Java虚拟机保存，或者该方法中已阻止另一个线程，并尝试锁定重叠区域
OverlappingFileLockException - 如果与该请求区域重叠的锁已由该Java虚拟机保留，或者该方法中已经阻止了另一个线程，并尝试锁定同一文件的重叠区域
tryLock
public abstractFileLocktryLock(longposition,
longsize,
booleanshared)
throws IOException
尝试获取此通道文件的给定区域的锁定。
此方法不阻止。 调用总是立即返回，要么获取了请求的区域的锁定，要么没有这样做。 如果由于重叠的锁被另一个程序持有而无法获取锁，则返回null 。 如果由于任何其他原因无法获取锁，则抛出适当的异常。
由position和size参数指定的区域不需要包含在实际的底层文件内，甚至与实际的底层文件重叠。 锁定区域的大小固定; 如果锁定区域最初包含文件的结尾，并且文件增长超出该区域，那么该文件的新部分将不会被该锁覆盖。 如果文件的大小增加，并且整个文件都需要锁定，则应该锁定从零开始并且不小于文件的预期最大大小的区域。 零参数tryLock()方法简单地锁定一个大小为Long.MAX_VALUE的区域。
某些操作系统不支持共享锁，在这种情况下，共享锁的请求将自动转换为独占锁的请求。 新获取的锁是共享的还是独占的都可以通过调用生成的锁定对象的isShared方法进行测试。
文件锁代表整个Java虚拟机。 它们不适用于通过同一虚拟机中的多个线程来控制对文件的访问。
OverlappingFileLockException - 如果与该请求区域重叠的锁已由该Java虚拟机保留，或者该方法中已阻止另一个线程，并尝试锁定同一文件的重叠区域
OverlappingFileLockException - 如果与该请求区域重叠的锁已由该Java虚拟机保留，或者该方法中是否已阻止另一个线程，并尝试锁定重叠区域
以上就是FileChannel (Java Platform SE 8 )（）的详细内容，想要了解更多 FileChannel (Java Platform SE 8 )的内容，请持续关注盛行IT软件开发工作室。
郑重声明：本文由网友发布，不代表盛行IT的观点，版权归原作者所有，仅为传播更多信息之目的，如有侵权请联系，我们将第一时间修改或删除，多谢。