Module java.base
Package java.nio.file.attribute

Interface DosFileAttributeView

所有超级接口:
AttributeView, BasicFileAttributeView, FileAttributeView
public interface DosFileAttributeView extends BasicFileAttributeView
提供对传统“DOS”文件属性的视图的文件属性视图。这些属性受到诸如通常用于消费设备的文件分配表（FAT）格式等文件系统的支持。

DosFileAttributeView是一个BasicFileAttributeView，此外还支持访问用于指示文件是否为只读、隐藏、系统文件或已存档的一组DOS属性标志。

如果需要动态访问文件属性，则此属性视图支持的属性由BasicFileAttributeView定义，并且还支持以下属性：

支持的属性
名称 类型
readonly Boolean
hidden Boolean
system Boolean
archive Boolean

getAttribute方法可用于读取这些属性中的任何一个，或者如同调用readAttributes()方法一样读取由BasicFileAttributeView定义的任何属性。

setAttribute方法可用于更新文件的最后修改时间、最后访问时间或创建时间属性，如BasicFileAttributeView中定义的那样。它还可用于更新DOS属性，就像分别调用setReadOnly、setHidden、setSystem和setArchive方法一样。

自1.7版本起:
1.7

  • Method Details

    • name

      String name()
      返回属性视图的名称。此类型的属性视图的名称为"dos"。
      指定者:
      name 在接口 AttributeView
      指定者:
      name 在接口 BasicFileAttributeView
      返回:
      属性视图的名称

    • readAttributes

      DosFileAttributes readAttributes() throws IOException
      从接口中复制的描述: BasicFileAttributeView
      作为批量操作读取基本文件属性。

      具体实现是否将所有文件属性作为原子操作读取，与其他文件系统操作有关。

      指定者:
      readAttributes 在接口 BasicFileAttributeView
      返回:
      文件属性
      抛出:
      IOException - 如果发生I/O错误
      SecurityException - 在默认提供程序的情况下，安装了安全管理器，将调用其checkRead方法以检查对文件的读取访问权限

    • setReadOnly

      void setReadOnly(boolean value) throws IOException
      更新只读属性的值。

      具体实现是否可以将属性更新为原子操作，与其他文件系统操作有关。例如，实现可能需要读取DOS属性的现有值以更新此属性。

      参数:
      value - 属性的新值
      抛出:
      IOException - 如果发生I/O错误
      SecurityException - 在默认情况下，如果安装了安全管理器，则将调用其checkWrite方法以检查对文件的写入访问权限

    • setHidden

      void setHidden(boolean value) throws IOException
      更新隐藏属性的值。

      具体实现是否可以将属性更新为原子操作，与其他文件系统操作有关。例如，实现可能需要读取DOS属性的现有值以更新此属性。

      参数:
      value - 属性的新值
      抛出:
      IOException - 如果发生I/O错误
      SecurityException - 在默认情况下，如果安装了安全管理器，则将调用其checkWrite方法以检查对文件的写入访问权限

    • setSystem

      void setSystem(boolean value) throws IOException
      更新系统属性的值。

      具体实现是否可以将属性更新为原子操作，与其他文件系统操作有关。例如，实现可能需要读取DOS属性的现有值以更新此属性。

      参数:
      value - 属性的新值
      抛出:
      IOException - 如果发生I/O错误
      SecurityException - 在默认情况下，如果安装了安全管理器，则将调用其checkWrite方法以检查对文件的写入访问权限

    • setArchive

      void setArchive(boolean value) throws IOException
      更新存档属性的值。

      具体实现是否可以将属性更新为原子操作，与其他文件系统操作有关。例如，实现可能需要读取DOS属性的现有值以更新此属性。

      参数:
      value - 属性的新值
      抛出:
      IOException - 如果发生I/O错误
      SecurityException - 在默认情况下，如果安装了安全管理器，则将调用其checkWrite方法以检查对文件的写入访问权限