Package java.nio.file

定义的接口和类的java虚拟机访问文件，文件属性，文件系统。

See: 描述

接口摘要

接口	描述
CopyOption	一个对象，配置如何复制或移动文件。
DirectoryStream<T>	一个对象遍历目录中的条目。
DirectoryStream.Filter<T>	由对象来实现的一个接口，该接口决定是否要接受或过滤目录条目。
FileVisitor<T>	一个文件的访客。
OpenOption	一个对象，配置如何打开或创建一个文件。
Path	可以用于在文件系统中定位文件的对象。
PathMatcher	通过在路径上执行匹配操作的对象来实现的接口。
SecureDirectoryStream<T>	一个 DirectoryStream定义操作是相对开放的目录文件。
Watchable	一个对象，可以注册一个手表服务，使它可以被监视的变化和事件。
WatchEvent<T>	一个对象，是一个 WatchService注册一个事件或重复的事件。
WatchEvent.Kind<T>	一种事件类型，用于识别的目的。
WatchEvent.Modifier	一个事件的修饰，使如何 Watchable与 WatchService注册。
WatchKey	一个令牌代表一个 WatchService watchable对象登记。
WatchService	手表的服务，手表注册的对象的变化和事件。

类摘要

类	描述
Files	这个类只包括对文件、目录或其他类型文件进行操作的静态方法。
FileStore	文件存储。
FileSystem	提供一个文件系统的接口，并为对象访问文件系统中的文件和其他对象的工厂。
FileSystems	文件系统的工厂方法。
LinkPermission	链接生成操作的 Permission类。
Paths	这类由专门的静态方法返回一个 Path通过转换路径字符串或 URI。
SimpleFileVisitor<T>	一个简单的访问者的文件，默认行为访问所有文件，并重新抛出I / O错误。
StandardWatchEventKinds	定义标准事件类型。

枚举摘要

Enum	描述
AccessMode	定义用于测试文件可访问性的访问模式。
FileVisitOption	定义文件树遍历选项。
FileVisitResult	一个 FileVisitor结果类型。
LinkOption	定义如何处理符号链接的选项。
StandardCopyOption	定义标准的复制选项。
StandardOpenOption	定义标准的开放选项。

异常摘要

异常	描述
AccessDeniedException	当文件系统操作被拒绝时，检查异常引发的异常，通常是由于文件权限或其他访问检查。
AtomicMoveNotSupportedException	当一个文件不能被移动时作为一个原子文件系统操作时检查异常抛出。
ClosedDirectoryStreamException	当在关闭正在关闭的目录流上的操作时，未检查异常引发的异常。
ClosedFileSystemException	当在为在一个文件上调用操作而引发的异常时，文件系统被关闭时。
ClosedWatchServiceException	当试图在关闭被关闭的监视服务上调用操作时，未检查异常引发的异常。
DirectoryIteratorException	运行时异常抛出如果I/O错误时遍历目录中的条目。
DirectoryNotEmptyException	当一个文件系统操作失败时，检查异常，因为目录不是空的。
FileAlreadyExistsException	尝试创建一个文件或目录时，并已存在该名称的文件时，检查异常抛出。
FileSystemAlreadyExistsException	当试图创建已存在的文件系统时，运行时异常抛出时引发的异常。
FileSystemException	当一个文件系统操作在一个或两个文件上失败时引发。
FileSystemLoopException	当遇到文件系统循环或周期时，检查异常抛出。
FileSystemNotFoundException	当找不到文件系统时，运行时异常引发。
InvalidPathException	未检查异常时抛出路径字符串不能转换成 Path因为路径字符串包含无效的字符，或路径字符串无效的其他文件系统的具体原因。
NoSuchFileException	尝试访问不存在的文件时，检查异常引发的异常。
NotDirectoryException	当一个文件系统操作时，用于目录的异常引发的异常，因为该文件不是目录。
NotLinkException	当一个文件系统操作失败，因为文件不是一个符号链接时，检查异常引发。
ProviderMismatchException	当试图调用由由不同的文件系统提供程序创建的参数的一个文件系统提供程序所创建的对象的方法时，未检查异常引发的异常抛出。
ProviderNotFoundException	当无法找到所需类型的提供程序时，运行时异常引发。
ReadOnlyFileSystemException	未检查异常抛出时，尝试更新与 read-only FileSystem相关的对象。

Package java.nio.file Description

定义的接口和类的java虚拟机访问文件，文件属性，文件系统。

java.nio.file包定义的访问文件和文件系统类型。API来访问文件和文件系统属性是在java.nio.file.attribute包定义。的java.nio.file.spi包是由服务提供商的用户希望延长平台默认提供程序使用，或建立其他提供者的实现。

Symbolic Links

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

Interoperability

的File类定义的转换路径的抽象的java.io.File对象表示的方法构造一个Path toPath。由此产生的Path可以用来操作在同一个文件的File对象。的Path规范提供Path和java.io.File对象之间的interoperability进一步信息。

能见度

的文件和在这个包中的类提供的文件系统视图的保证是通过在同一个java虚拟机的其他实例提供的其他观点一致。视图可能会或可能不会，但是，与其他并发运行程序所看到的文件系统的视图是一致的，由于底层的操作系统和网络文件系统协议的延迟所执行的缓存。这是真的，不管这些其他程序的语言是写的，以及它们是否在同一台机器上运行，或在其他机器上运行的语言。任何这样的不一致的确切性质是系统依赖性，因此未指定。

Synchronized I/O File Integrity

的SYNC和DSYNC选项使用时打开一个文件需要更新的文件同步写入到存储装置。在默认的提供程序的情况下，该文件驻留在本地存储设备，和seekable通道连接到一个文件，打开其中一个选项，然后对write方法调用只保证返回时，所有的更改的文件，调用已写入设备。这些选项是有用的，以确保关键信息不会丢失在系统崩溃的事件。如果该文件不驻留在本地设备上，则没有这样的保证。这是否是可能的与其他provider实现提供程序特定的。

一般例外

除非另有说明，通过null实参构造函数或方法的任何类或接口在这个包会导致NullPointerException被。此外，调用方法与集合包含一个null元素将导致NullPointerException，除非另有规定。

除非另有说明，试图访问该文件系统将ClosedFileSystemException调用时用FileSystem已closed相关对象的方法。此外，任何方法尝试写入权限的文件系统将ReadOnlyFileSystemException调用时用FileSystem只提供只读访问相关的对象。

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

选择特定的例外情况

大多数方法由类定义在这个包中，指定 IOException被I/O错误时发生访问文件系统。在某些情况下，这些方法为常见的情况下定义特定的I / O异常。这些异常，以选择特定的例外情况，抛出的实施可以检测特定的错误。在特定的错误不能检测到更一般的 IOException抛出。

从以下版本开始：

1.7