模块  java.base

Package java.nio.file

定义Java虚拟机的接口和类,以访问文件,文件属性和文件系统。

java.nio.file包定义了访问文件和文件系统的类。 访问文件和文件系统属性的API在java.nio.file.attribute包中定义。 java.nio.file.spi程序包由希望扩展平台默认提供程序或构建其他提供程序实现的服务提供程序实现者使用。

Symbolic Links

许多操作系统和文件系统都支持符号链接 符号链接是一个特殊文件,用作对另一个文件的引用。 在大多数情况下,符号链接对应用程序是透明的,符号链接上的操作会自动重定向到链接的目标 例外情况是删除或重命名/移动符号链接时,在这种情况下删除或删除链接而不是链接的目标。 此包包括对实现提供这些语义的符号链接的支持。 文件系统可能支持语义上接近的其他类型,但此包中不包含对这些其他类型链接的支持。

Interoperability

File类通过转换由java.io.File对象表示的抽象路径来定义构造PathtoPath方法。 生成的Path可用于在与File对象相同的文件上File 所述Path说明书提供了关于进一步的信息interoperability之间Pathjava.io.File对象。

能见度

此包中的类提供的文件和文件系统视图保证与同一Java虚拟机中其他实例提供的其他视图一致。 然而,由于底层操作系统执行的高速缓存和网络文件系统协议引起的延迟,视图可能会也可能不会与其他并发运行的程序所看到的文件系统的视图一致。 无论编写这些其他程序的语言是什么,以及它们是在同一台机器上运行还是在其他机器上运行,都是如此。 任何此类不一致的确切性质都取决于系统,因此未指定。

Synchronized I/O File Integrity

打开文件时要使用SYNCDSYNC选项,要求将文件更新同步写入底层存储设备。 对于默认提供程序,并且文件驻留在本地存储设备上,并且seekable通道连接到使用这些选项之一打开的文件,则只能保证调用write方法通过该调用对文件所做的更改已写入设备。 这些选项对于确保在系统崩溃时不会丢失关键信息非常有用。 如果文件不驻留在本地设备上,则不会进行此类保证。 是否可以通过其他provider实现进行此保证是特定于提供程序的。

一般例外情况

除非另有说明,否则将null参数传递给此包中任何类或接口的构造函数或方法将导致抛出NullPointerException 此外,除非另行指定,否则使用包含null元素的数组或集合调用方法将导致NullPointerException

除非另有说明,尝试访问文件系统的方法将引发ClosedFileSystemException与一个关联的对象调用时FileSystem已经closed 此外,任何尝试对文件系统进行写访问的方法在与仅提供只读访问的FileSystem关联的对象上调用时将抛出ReadOnlyFileSystemException

除非另有说明,否则调用由一个provider创建的此包中的任何类或接口的方法,其参数是由另一个提供者创建的对象,将抛出ProviderMismatchException

可选的特定例外

此程序包中由访问文件系统的类定义的大多数方法指定在发生I / O错误时抛出IOException 在某些情况下,这些方法为常见情况定义特定的I / O异常。 这些异常(称为可选的特定异常)由实现抛出,它可以检测特定错误。 如果无法检测到特定错误,则抛出更一般的IOException
从以下版本开始:
1.7