compact1, compact2, compact3

java.nio.file.spi

Class FileSystemProvider

java.lang.Object

java.nio.file.spi.FileSystemProvider

public abstract class FileSystemProvider
extends Object

文件系统的服务提供程序类。由 Files类中定义的方法通常会代表这个类的一个实例。

一个文件系统提供程序是实现这个类定义的抽象方法的一个具体实现。一个供应商的URI scheme鉴定。默认提供程序由URI方案“文件”。它创造了FileSystem提供访问文件系统的java虚拟机访问。的FileSystems类定义了文件系统提供商定位和加载。默认提供程序是一个典型的系统默认提供程序可重写如果系统性能java.nio.file.spi.DefaultFileSystemProvider设置。在这种情况下，供应商有一一个参数的构造函数的形参类型是FileSystemProvider。所有其他的供应商有一零个参数的构造函数初始化提供程序。

提供程序是一个或多个实例的工厂FileSystem。每个文件系统是由一个URI其中URI方案相匹配的供应商的scheme鉴定。例如，默认的文件系统，是由URI "file:///"鉴定。一种基于内存的文件系统，例如，可以由一个URI如"memory:///?name=logfs"鉴定，newFileSystem方法可以用来创建一个文件系统，和getFileSystem方法可以用来获得一个现有文件系统的提供者。在供应商工厂为一个单一的文件系统，则供应商依赖如果文件系统被创建时，提供程序初始化，或后来newFileSystem方法被调用。在默认的提供程序的情况下，该FileSystem时创建的提供程序初始化。

在这个类中的所有方法都是安全的，使用多个并发线程。

从以下版本开始：

一点七

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	FileSystemProvider() 初始化该类的一个新实例。

方法摘要

Modifier and Type	Method and Description
abstract void	checkAccess(Path path, AccessMode... modes) 检查是否存在一个文件的存在性和可选的可访问性。
abstract void	copy(Path source, Path target, CopyOption... options) 将一个文件复制到目标文件。
abstract void	createDirectory(Path dir, FileAttribute<?>... attrs) 创建一个新目录。
void	createLink(Path link, Path existing) 为现有文件创建一个新的链接（目录项）。
void	createSymbolicLink(Path link, Path target, FileAttribute<?>... attrs) 创建一个目标的符号链接。
abstract void	delete(Path path) 删除一个文件。
boolean	deleteIfExists(Path path) 如果它存在的话，删除一个文件。
abstract <V extends FileAttributeView> V	getFileAttributeView(Path path, 类<V> type, LinkOption... options) 返回一个给定类型的文件属性视图。
abstract FileStore	getFileStore(Path path) 返回 FileStore代表文件存储在一个文件的位置。
abstract FileSystem	getFileSystem(URI uri) 返回一个现有的 FileSystem该提供程序创建。
abstract Path	getPath(URI uri) 通过将给定的 URI返回 Path对象。
abstract String	getScheme() 返回的URI方案标识提供者。
static List<FileSystemProvider>	installedProviders() 返回已安装的文件系统供应商的列表。
abstract boolean	isHidden(Path path) 告诉是否一个文件被认为是隐藏的。
abstract boolean	isSameFile(Path path, Path path2) 测试如果两个路径定位相同的文件。
abstract void	move(Path source, Path target, CopyOption... options) 移动或重命名一个文件到目标文件。
AsynchronousFileChannel	newAsynchronousFileChannel(Path path, Set<? extends OpenOption> options, ExecutorService executor, FileAttribute<?>... attrs) 打开或创建一个用于读取和/或写入的文件，返回一个异步文件通道来访问该文件。
abstract SeekableByteChannel	newByteChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) 打开或创建一个文件，返回一个可寻址的字节通道存取文件。
abstract DirectoryStream<Path>	newDirectoryStream(Path dir, DirectoryStream.Filter<? super Path> filter) 打开目录，返回一个 DirectoryStream遍历目录中的条目。
FileChannel	newFileChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) 打开或创建一个用于读取和/或写入的文件，返回一个文件通道以访问该文件。
FileSystem	newFileSystem(Path path, Map<String,?> env) 构建访问一个文件的内容作为一个文件系统的一个新的 FileSystem。
abstract FileSystem	newFileSystem(URI uri, Map<String,?> env) 构建了一种新的 FileSystem对象由URI标识。
InputStream	newInputStream(Path path, OpenOption... options) 打开一个文件，返回一个输入流从文件中读取。
OutputStream	newOutputStream(Path path, OpenOption... options) 打开或创建一个文件，返回一个可用于将字节写入文件的输出流。
abstract <A extends BasicFileAttributes> A	readAttributes(Path path, 类<A> type, LinkOption... options) 读取一个文件的属性作为一个批量操作。
abstract Map<String,Object>	readAttributes(Path path, String attributes, LinkOption... options) 读取一组文件属性作为批量操作。
Path	readSymbolicLink(Path link) 读取符号链接的目标。
abstract void	setAttribute(Path path, String attribute, Object value, LinkOption... options) 设置文件属性的值。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FileSystemProvider

protected FileSystemProvider()

初始化该类的一个新实例。

在施工过程中，供应商可以安全地访问与默认供应商相关的文件，但需要采取以避免其他已安装的供应商的循环加载。如果检测到已安装的服务提供商的循环加载，则抛出一个未指定的错误。

异常

SecurityException如果安全管理器已经安装，它否认 RuntimePermission ("fileSystemProvider")

方法详细信息

installedProviders

public static List<FileSystemProvider> installedProviders()

返回已安装的文件系统供应商的列表。

这种方法的第一次调用会默认提供程序被初始化（如果尚未初始化）和负载安装的其他供应商的FileSystems类描述。

结果

安装的文件系统提供一个不可修改的列表。列表中至少包含一个元素，这是默认的文件系统提供商

异常

ServiceConfigurationError -当错误发生时加载服务提供商时

getScheme

public abstract String getScheme()

返回的URI方案标识提供者。

结果

URI方案

newFileSystem

public abstract FileSystem newFileSystem(URI uri,
                                         Map<String,?> env)
                                  throws IOException

构建了一种新的 FileSystem对象由URI标识。该方法由 FileSystems.newFileSystem(URI,Map)方法调用来打开一个新文件系统由URI标识。

的uri参数是一个绝对的、分层的URI，一个方案相同（不考虑的情况下）的供应商支持方案。URI的确切形式是高度依赖供应商。的env参数是一个Map供应商特定的属性配置文件系统。

该方法将FileSystemAlreadyExistsException如果文件系统已经存在，因为它以前是由该方法的调用创建。一旦一个文件系统是closed是供应商依赖如果提供者允许一个新的文件系统与URI作为先前创建的文件系统的创建。

参数

uri - URI引用

env -Map供应商特定的属性配置文件系统；可能是空的

结果

一个新的文件系统

异常

IllegalArgumentException如果为 uri参数不预条件满足，或 env参数不包含由供应商所要求的属性，或属性值无效

IOException - I/O错误时创建文件系统

SecurityException如果安全管理器安装，它否认未经文件系统供应商实施要求

FileSystemAlreadyExistsException -如果文件系统已经创建

getFileSystem

public abstract FileSystem getFileSystem(URI uri)

返回一个现有的 FileSystem该提供程序创建。

此方法返回一个引用一个FileSystem被调用newFileSystem(URI,Map)方法创建。文件系统创建的newFileSystem(Path,Map)法此方法不返回。文件系统是通过URI鉴定。其确切形式是高度依赖供应商。在默认的提供程序的URI的路径部分案件"/"和权威，查询片段组件定义（定义的组件是由null）。

一旦该提供程序创建的文件系统closed是供应商依赖如果这个方法返回一个引用到关闭文件系统或抛出FileSystemNotFoundException。如果提供者允许一个新的文件系统与URI作为它先前创建的这个方法抛出异常后，如果调用文件系统是封闭的文件系统一样创建（和之前的一个新实例的newFileSystem方法创建的）。

如果一个安全管理器被安装，那么一个提供者的实现可能需要在返回一个引用之前检查一个现有的文件系统的权限。在default文件系统的情况下，没有权限检查是必需的。

参数

uri - URI引用

结果

文件系统

异常

IllegalArgumentException如果为 uri参数不符合条件的预

FileSystemNotFoundException -如果文件系统不存在

SecurityException如果安全管理器安装和否定一个未指定的权限。

getPath

public abstract Path getPath(URI uri)

通过将给定的 URI返回 Path对象。由此产生的 Path与 FileSystem已经存在的或相关的自动构造。

URI的精确形式的文件系统供应商的依赖。在默认的提供程序的情况下，URI方案"file"和给定的URI的一个非空的路径组件，并定义的查询，和片段组成。由此产生的Path和默认default FileSystem相关。

如果一个安全管理器被安装，那么一个提供程序实现可能需要检查一个权限。在default文件系统的情况下，没有权限检查是必需的。

参数

uri - URI转换

结果

由此产生的 Path

异常

IllegalArgumentException -如果URI方案不确定这个供应商或其他条件的URI参数不成立

FileSystemNotFoundException -文件系统，由URI标识，不存在不能自动创建

SecurityException如果安全管理器安装和否定一个未指定的权限。

newFileSystem

public FileSystem newFileSystem(Path path,
                                Map<String,?> env)
                         throws IOException

构建访问一个文件的内容作为一个文件系统的一个新的 FileSystem。

这种方法的目的是为一个或多个文件的内容被视为一个文件系统的伪文件系统的专门供应商。的env参数是一个Map供应商特定的属性配置文件系统。

如果提供程序不支持这种文件系统的创建或如果供应商没有认识到给定的文件的文件类型然后把UnsupportedOperationException。此方法的默认实现将UnsupportedOperationException。

参数

path -文件的路径

env -Map供应商特定的属性配置文件系统；可能是空的

结果

一个新的文件系统

异常

UnsupportedOperationException -如果该提供程序不支持访问的内容作为一个文件系统或不承认给定文件的文件类型

IllegalArgumentException -如果 env参数不包含由供应商所要求的属性，或属性值无效

IOException如果I/O错误发生

SecurityException如果安全管理器安装和否定一个未指定的权限。

newInputStream

public InputStream newInputStream(Path path,
                                  OpenOption... options)
                           throws IOException

打开一个文件，返回一个输入流从文件中读取。这种方法完全相同的方式，通过 Files.newInputStream(java.nio.file.Path, java.nio.file.OpenOption...)方法指定的工作。

此方法的默认实现打开一个通道的文件如果通过调用newByteChannel(java.nio.file.Path, java.util.Set<? extends java.nio.file.OpenOption>, java.nio.file.attribute.FileAttribute<?>...)方法构建了一个流读取字节的通道。这种方法应该被适当的地方。

参数

path -文件路径打开

options选项指定如何打开文件

结果

一个新的输入流

异常

IllegalArgumentException如果选项指定无效的组合

UnsupportedOperationException -如果不支持指定的选项

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkRead方法被调用来检查对文件的读访问。

newOutputStream

public OutputStream newOutputStream(Path path,
                                    OpenOption... options)
                             throws IOException

打开或创建一个文件，返回一个可用于将字节写入文件的输出流。这种方法完全相同的方式，通过 Files.newOutputStream(java.nio.file.Path, java.nio.file.OpenOption...)方法指定的工作。

此方法的默认实现打开一个通道的文件如果通过调用newByteChannel(java.nio.file.Path, java.util.Set<? extends java.nio.file.OpenOption>, java.nio.file.attribute.FileAttribute<?>...)方法构建了一个流写入字节的通道。这种方法应该被适当的地方。

参数

path -文件路径打开或创建

options选项指定如何打开文件

结果

一个新的输出流

异常

IllegalArgumentException -如果 options包含选项无效组合

UnsupportedOperationException -如果不支持指定的选项

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkWrite方法被调用来检查文件的写访问。的 checkDelete方法被调用来检查文件是否是打开的 DELETE_ON_CLOSE选项删除访问。

newFileChannel

public FileChannel newFileChannel(Path path,
                                  Set<? extends OpenOption> options,
                                  FileAttribute<?>... attrs)
                           throws IOException

打开或创建一个用于读取和/或写入的文件，返回一个文件通道以访问该文件。这种方法完全相同的方式，通过 FileChannel.open方法指定的工作。提供程序不支持所需的所有功能来创建一个文件的通道将 UnsupportedOperationException。默认提供程序所支持的文件创建管道。当不重写默认实现将 UnsupportedOperationException。

参数

path -打开或创建的文件的路径

options选项指定如何打开文件

attrs -文件的可选列表属性设置自动创建文件时

结果

一个新的文件通道

异常

IllegalArgumentException如果集包含一个无效的组合选择

UnsupportedOperationException如果提供者不支持创建文件的渠道，或不支持的开放式期权或文件属性指定

IOException如果I/O错误发生

SecurityException在默认的文件系统的情况下，该 SecurityManager.checkRead(String)方法被调用来检查读访问如果文件打开阅读。的 SecurityManager.checkWrite(String)方法被调用来检查写访问如果文件打开写作

newAsynchronousFileChannel

public AsynchronousFileChannel newAsynchronousFileChannel(Path path,
                                                          Set<? extends OpenOption> options,
                                                          ExecutorService executor,
                                                          FileAttribute<?>... attrs)
                                                   throws IOException

打开或创建一个用于读取和/或写入的文件，返回一个异步文件通道来访问该文件。这种方法完全相同的方式，通过 AsynchronousFileChannel.open方法指定的工作。提供程序不支持所有的功能需要构造一个异步文件通道将 UnsupportedOperationException。需要默认的提供程序以支持异步文件通道的创建。当不重写此方法的默认实现将 UnsupportedOperationException。

参数

path -打开或创建的文件的路径

options选项指定如何打开文件

executor -线程池或 null联想渠道与默认的线程池

attrs -文件的可选列表属性设置自动创建文件时

结果

一种新的异步文件通道

异常

IllegalArgumentException如果集包含一个无效的组合选择

UnsupportedOperationException如果提供者不支持创建异步文件渠道，或不支持的开放式期权或文件属性指定

IOException如果I/O错误发生

SecurityException在默认的文件系统的情况下，该 SecurityManager.checkRead(String)方法被调用来检查读访问如果文件打开阅读。的 SecurityManager.checkWrite(String)方法被调用来检查写访问如果文件打开写作

newByteChannel

public abstract SeekableByteChannel newByteChannel(Path path,
                                                   Set<? extends OpenOption> options,
                                                   FileAttribute<?>... attrs)
                                            throws IOException

打开或创建一个文件，返回一个可寻址的字节通道存取文件。这种方法完全相同的方式，通过 Files.newByteChannel(Path,Set,FileAttribute[])方法指定的工作。

参数

path -文件路径打开或创建

options选项指定如何打开文件

attrs -文件的可选列表属性设置自动创建文件时

结果

一个新的可寻址字节通道

异常

IllegalArgumentException如果集包含一个无效的组合选择

UnsupportedOperationException -如果不支持打开选项指定或数组包含不能设置自动创建文件时的属性

FileAlreadyExistsException -如果这个名字已经存在， CREATE_NEW选项指定的文件（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkRead方法被调用来检查文件是否被打开阅读读访问路径。的 checkWrite方法被调用来检查写访问路径，如果文件打开写作。的 checkDelete方法被调用来检查文件是否是打开的 DELETE_ON_CLOSE选项删除访问。

newDirectoryStream

public abstract DirectoryStream<Path> newDirectoryStream(Path dir,
                                                         DirectoryStream.Filter<? super Path> filter)
                                                  throws IOException

打开目录，返回一个 DirectoryStream遍历目录中的条目。这种方法完全相同的方式，通过 Files.newDirectoryStream(java.nio.file.Path, java.nio.file.DirectoryStream.Filter)方法指定的工作。

参数

dir -路径的目录

filter -目录流过滤器

结果

一个新的、开放的 DirectoryStream对象

异常

NotDirectoryException -如果文件不能打开，因为它不是一个目录（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkRead方法被调用，检查访问的目录读取。

createDirectory

public abstract void createDirectory(Path dir,
                                     FileAttribute<?>... attrs)
                              throws IOException

创建一个新目录。这种方法完全相同的方式，通过 Files.createDirectory(java.nio.file.Path, java.nio.file.attribute.FileAttribute<?>...)方法指定的工作。

参数

dir -目录的创建

attrs -文件的可选列表属性设置时自动创建目录

异常

UnsupportedOperationException -如果数组包含一个属性不能设置自动创建目录的时候

FileAlreadyExistsException -如果一个目录不能创建因为名称的文件已经存在（可选特定异常）

IOException -如果发生I/O错误或父目录不存在

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkWrite方法被调用来检查写访问新的目录。

createSymbolicLink

public void createSymbolicLink(Path link,
                               Path target,
                               FileAttribute<?>... attrs)
                        throws IOException

创建一个目标的符号链接。这种方法完全相同的方式，通过 Files.createSymbolicLink(java.nio.file.Path, java.nio.file.Path, java.nio.file.attribute.FileAttribute<?>...)方法指定的工作。

此方法的默认实现将UnsupportedOperationException。

参数

link -符号链接路径创造

target -符号链接目标

attrs -属性的数组设置自动创建符号链接时

异常

UnsupportedOperationException如果实现不支持符号链接或数组包含一个属性不能设置自动创建符号链接时

FileAlreadyExistsException -如果一个名称的文件已经存在（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器安装，它否认 LinkPermission ("symbolic")或其 checkWrite方法拒绝写访问的符号链接的路径。

createLink

public void createLink(Path link,
                       Path existing)
                throws IOException

为现有文件创建一个新的链接（目录项）。这种方法完全相同的方式，通过 Files.createLink(java.nio.file.Path, java.nio.file.Path)方法指定的工作。

此方法的默认实现将UnsupportedOperationException。

参数

link -链接（目录项）创建

existing -一个现有文件的路径

异常

UnsupportedOperationException -如果实现不支持添加现有文件到一个目录

FileAlreadyExistsException -如果入口不能创建因为名称的文件已经存在（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器安装，它否认 LinkPermission ("hard")或其 checkWrite方法拒绝写访问的链接或现有的文件。

delete

public abstract void delete(Path path)
                     throws IOException

删除一个文件。这种方法完全相同的方式，通过 Files.delete(java.nio.file.Path)方法指定的工作。

参数

path -文件路径删除

异常

NoSuchFileException -如果文件不存在（可选特定异常）

DirectoryNotEmptyException -如果文件是一个目录，否则不能被删除，因为目录不是空的（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， SecurityManager.checkDelete(String)方法被调用来检查删除文件

deleteIfExists

public boolean deleteIfExists(Path path)
                       throws IOException

如果它存在的话，删除一个文件。这种方法完全相同的方式，通过 Files.deleteIfExists(java.nio.file.Path)方法指定的工作。

此方法的默认实现调用delete(java.nio.file.Path)简单忽略NoSuchFileException当文件不存在。它可以被覆盖在适当的地方。

参数

path -文件路径删除

结果

true如果文件进行删除； false如果文件不能被删除，因为它不存在

异常

DirectoryNotEmptyException -如果文件是一个目录，否则不能被删除，因为目录不是空的（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， SecurityManager.checkDelete(String)方法被调用来检查删除文件

readSymbolicLink

public Path readSymbolicLink(Path link)
                      throws IOException

读取符号链接的目标。这种方法完全相同的方式，通过 Files.readSymbolicLink(java.nio.file.Path)方法指定的工作。

此方法的默认实现将UnsupportedOperationException。

参数

link -路径的符号链接

结果

符号链接的目标

异常

UnsupportedOperationException如果实现不支持符号链接

NotLinkException -如果目标不能被读取，文件不是一个符号链接（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器安装，检查， FilePermission获“ readlink”行动，阅读链接。

copy

public abstract void copy(Path source,
                          Path target,
                          CopyOption... options)
                   throws IOException

将一个文件复制到目标文件。这种方法完全相同的方式，通过 Files.copy(Path,Path,CopyOption[])法规定除了两源和目标路径必须与供应商联系。

参数

source -路径的文件复制

target -路径的目标文件

options选项指定如何复制应该做的

异常

UnsupportedOperationException -如果数组包含一个复制选项不支持

FileAlreadyExistsException -如果目标文件存在，但不能因为没有指定 REPLACE_EXISTING选项替换（可选特定异常）

DirectoryNotEmptyException - REPLACE_EXISTING选项指定但文件不能是因为它是一个非空的目录替换（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkRead方法被调用来检查访问源文件的读取，这 checkWrite调用检查写入目标文件。如果一个符号链接复制安全管理是用来检查 LinkPermission ("symbolic")。

move

public abstract void move(Path source,
                          Path target,
                          CopyOption... options)
                   throws IOException

移动或重命名一个文件到目标文件。这种方法完全相同的方式，通过 Files.move(java.nio.file.Path, java.nio.file.Path, java.nio.file.CopyOption...)法规定除了两源和目标路径必须与供应商联系。

参数

source -文件的路径移动

target -路径的目标文件

options选项指定如何移动应该做的

异常

UnsupportedOperationException -如果数组包含一个复制选项不支持

FileAlreadyExistsException -如果目标文件存在，但不能因为没有指定 REPLACE_EXISTING选项替换（可选特定异常）

DirectoryNotEmptyException - REPLACE_EXISTING选项指定但文件不能是因为它是一个非空的目录替换（可选特定异常）

AtomicMoveNotSupportedException如果选项数组包含 ATOMIC_MOVE选项但无法移动文件作为一个原子操作文件系统。

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkWrite方法被调用来检查写访问的源和目标文件。

isSameFile

public abstract boolean isSameFile(Path path,
                                   Path path2)
                            throws IOException

测试如果两个路径定位相同的文件。这种方法完全相同的方式，通过 Files.isSameFile(java.nio.file.Path, java.nio.file.Path)方法指定的工作。

参数

path -一个文件的路径

path2 -其他路径

结果

true如果，仅仅是如果，两路径定位相同的文件

异常

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkRead方法被调用来检查访问文件读取。

isHidden

public abstract boolean isHidden(Path path)
                          throws IOException

告诉是否一个文件被认为是隐藏的。这种方法完全相同的方式，通过 Files.isHidden(java.nio.file.Path)方法指定的工作。

该方法由isHidden方法调用。

参数

path -文件路径测试

结果

true如果文件是隐藏的

异常

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkRead方法被调用来检查对文件的读访问。

getFileStore

public abstract FileStore getFileStore(Path path)
                                throws IOException

返回 FileStore代表文件存储在一个文件的位置。这种方法完全相同的方式，通过 Files.getFileStore(java.nio.file.Path)方法指定的工作。

参数

path -文件的路径

结果

存储文件的文件存储区

异常

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器的安装， checkRead方法被调用来检查读取该文件，并检查 RuntimePermission ("getFileStoreAttributes")

checkAccess

public abstract void checkAccess(Path path,
                                 AccessMode... modes)
                          throws IOException

检查是否存在一个文件的存在性和可选的可访问性。

这种方法可以由isReadable使用，isWritable和isExecutable方法来检查文件的可访问性。

这种方法检查一个文件是否存在，这个java虚拟机具有适当的权限，可以访问文件，根据接入方式的modes参数如下：

Value	描述
READ	Checks that the file exists and that the Java virtual machine has permission to read the file.
WRITE	Checks that the file exists and that the Java virtual machine has permission to write to the file,
EXECUTE	Checks that the file exists and that the Java virtual machine has permission to execute the file. The semantics may differ when checking access to a directory. For example, on UNIX systems, checking for EXECUTE access checks that the Java virtual machine has permission to search the directory in order to access file or subdirectories.

如果modes参数的长度是零，那么存在的文件检查。

如果此对象引用的文件是一个符号链接，则此方法如下。根据实现，这种方法可能需要读取文件的权限，访问控制列表，或其他文件属性，以检查文件的有效访问。要确定对一个文件的有效访问可能需要访问几个属性，因此在某些实现中，这种方法可能不会对其他文件系统操作的原子性。

参数

path -路径的文件检查

modes -检查接入方式；可以有零个元素

异常

UnsupportedOperationException -实施需支持检查 READ， WRITE，和 EXECUTE访问。这个例外是指定允许的 Access枚举在将来的版本中被扩展。

NoSuchFileException -如果一个文件不存在（可选特定异常）

AccessDeniedException -请求的访问将被拒绝或访问不能被确定，因为java虚拟机有权限不足或其他原因。（可选特定异常）

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器安装的 checkRead被调用时检查访问文件或仅存在的文件读的 checkWrite被调用时，检查文件的写访问，并 checkExec调用时执行访问检查。

getFileAttributeView

public abstract <V extends FileAttributeView> V getFileAttributeView(Path path,
                                                                     类<V> type,
                                                                     LinkOption... options)

返回一个给定类型的文件属性视图。这种方法完全相同的方式，通过 Files.getFileAttributeView(java.nio.file.Path, java.lang.Class<V>, java.nio.file.LinkOption...)方法指定的工作。

参数类型

V - FileAttributeView型

参数

path -文件的路径

type -对应的文件属性查看 类对象

options选项指示如何处理符号链接

结果

一个指定类型的文件属性查看，或 null如果属性视图类型不可用

readAttributes

public abstract <A extends BasicFileAttributes> A readAttributes(Path path,
                                                                 类<A> type,
                                                                 LinkOption... options)
                                                          throws IOException

读取一个文件的属性作为一个批量操作。这种方法完全相同的方式，通过 Files.readAttributes(Path,Class,LinkOption[])方法指定的工作。

参数类型

A - BasicFileAttributes型

参数

path -文件的路径

type -文件的 类属性要求读

options选项指示如何处理符号链接

结果

文件属性

异常

UnsupportedOperationException -如果不支持一个给定类型的属性

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，安装安全管理器，它的 checkRead方法被调用来检查对文件的读访问

readAttributes

public abstract Map<String,Object> readAttributes(Path path,
                                                  String attributes,
                                                  LinkOption... options)
                                           throws IOException

读取一组文件属性作为批量操作。这种方法完全相同的方式，通过 Files.readAttributes(Path,String,LinkOption[])方法指定的工作。

参数

path -文件的路径

attributes -读取属性

options选项指示如何处理符号链接

结果

返回的属性的映射；可能是空的。Map的键是属性名，它的值是属性值

异常

UnsupportedOperationException -如果属性视图不可用

IllegalArgumentException -如果没有属性指定的或无法识别的属性指定

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器安装，其 checkRead法否认对文件的读访问。如果调用此方法读取安全敏感属性，则安全管理器可能会调用以检查是否有额外的权限。

setAttribute

public abstract void setAttribute(Path path,
                                  String attribute,
                                  Object value,
                                  LinkOption... options)
                           throws IOException

设置文件属性的值。这种方法完全相同的方式，通过 Files.setAttribute(java.nio.file.Path, java.lang.String, java.lang.Object, java.nio.file.LinkOption...)方法指定的工作。

参数

path -文件的路径

attribute -属性设置

value -属性值

options选项指示如何处理符号链接

异常

UnsupportedOperationException -如果属性视图不可用

IllegalArgumentException -如果没有指定属性名，或不认可，或属性值的正确类型，但有一个不适当的值

ClassCastException -如果属性值不是预期的类型或是一个集合，不是预期的类型元素

IOException如果I/O错误发生

SecurityException在默认提供程序的情况下，和安全管理器安装，其 checkWrite方法拒绝写访问文件。如果调用此方法来设置安全敏感属性，则可以调用安全管理器来检查是否有额外的权限。