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

Class FileStore


  • public abstract class FileStore
extends Object
    文件存储 A FileStore表示存储池，设备，分区，卷，具体文件系统或其他实现文件存储的具体方式。 所述FileStore用于文件的存储位置是通过调用得到getFileStore的方法，或所有文件存储可以通过调用被枚举getFileStores方法。

    除了此类定义的方法之外，文件存储可以支持一个或多个FileStoreAttributeView类，它们提供一组文件存储属性的只读或可更新视图。

    从以下版本开始：
    1.7

    • 构造方法详细信息

      • FileStore

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

    • 方法详细信息

      • name

        public abstract String name​()
        返回此文件存储的名称。 名称的格式高度实现具体。 它通常是存储池或卷的名称。

        此方法返回的字符串可能与toString方法返回的字符串不同。

        结果
        该文件存储的名称

      • type

        public abstract String type​()
        返回此文件存储的类型 。 此方法返回的字符串的格式具有高度实现性。 它可以指示例如所使用的格式或者文件存储是本地还是远程的。
        结果
        一个表示此文件存储类型的字符串

      • isReadOnly

        public abstract boolean isReadOnly​()
        告诉这个文件存储是否是只读的。 如果文件不支持写入操作或文件的其他更改，则文件存储是只读的。 任何尝试创建文件，打开现有文件以进行写入等都会导致抛出IOException 。
        结果
        true如果，并且只有这个文件存储是只读的

      • getTotalSpace

        public abstract long getTotalSpace​()
                            throws IOException
        返回文件存储的大小（以字节为单位）。
        结果
        文件存储的大小（以字节为单位）
        异常
        IOException - 如果发生I / O错误

      • getUsableSpace

        public abstract long getUsableSpace​()
                             throws IOException
        返回文件存储上此Java虚拟机可用的字节数。

        返回的可用字节数是一个提示，但不是保证，可以使用大多数或任何这些字节。 在获得空间属性之后，可用字节数很可能是准确的。 任何外部I / O操作（包括在此Java虚拟机之外的系统上进行的操作）都可能导致不准确。

        结果
        可用字节数
        异常
        IOException - 如果发生I / O错误

      • getUnallocatedSpace

        public abstract long getUnallocatedSpace​()
                                  throws IOException
        返回文件存储区中未分配字节的数量。

        返回的未分配字节数是一个提示，但不是保证，可以使用大多数或任何这些字节。 在获得空间属性之后，未分配字节的数量很可能是准确的。 任何外部I / O操作（包括在该虚拟机之外的系统上进行的操作）都可能导致不准确。

        结果
        未分配字节数
        异常
        IOException - 如果发生I / O错误

      • supportsFileAttributeView

        public abstract boolean supportsFileAttributeView​(Class<? extends FileAttributeView> type)
        告诉这个文件存储是否支持由给定文件属性视图标识的文件属性。

        调用此方法来测试文件库是否支持BasicFileAttributeView将始终返回true 。 在默认提供程序的情况下，当文件存储不是本地存储设备时，此方法不能保证给出正确的结果。 其原因是实施具体的，因此是未指定的。

        参数
        type - 文件属性视图类型
        结果
        true如果，且仅当支持文件属性视图

      • supportsFileAttributeView

        public abstract boolean supportsFileAttributeView​(String name)
        告诉这个文件存储是否支持由给定文件属性视图标识的文件属性。

        调用此方法来测试文件库是否支持BasicFileAttributeView ，由名称“ basic ”标识将始终返回true 。 在默认提供程序的情况下，当文件存储不是本地存储设备时，此方法不能保证给出正确的结果。 其原因是实施具体的，因此是未指定的。

        参数
        name - 文件属性视图的 name
        结果
        true如果并且仅当支持文件属性视图

      • getFileStoreAttributeView

        public abstract <V extends FileStoreAttributeView> V getFileStoreAttributeView​(Class<V> type)
        返回给定类型的FileStoreAttributeView 。

        该方法旨在用于文件存储属性视图定义类型安全方法来读取或更新文件存储属性。 type参数是所需的属性视图的类型，如果支持该方法，该方法返回该类型的实例。

        参数类型
        V - FileStoreAttributeView类型
        参数
        type - 对应于属性视图的 Class对象
        结果
        指定类型的文件存储属性视图，如果属性视图不可用， null

      • getAttribute

        public abstract Object getAttribute​(String attribute)
                             throws IOException
        读取文件存储属性的值。

        attribute参数标识要读取的属性，并采取以下格式：

        view-name : attribute-name
        字符':'代表自身。

        view-name是标识一组文件属性的AttributeView的name 。 attribute-name是属性的名称 。

        使用示例：假设我们想知道是否启用了ZFS压缩（假设支持“zfs”视图）： 

          boolean compression = (Boolean)fs.getAttribute("zfs:compression");
        参数
        attribute - 要读取的属性
        结果
        属性值 null可能对某些属性有效
        异常
        UnsupportedOperationException - 如果属性视图不可用或不支持读取属性
        IOException - 如果发生I / O错误