FileOwnerAttributeView - Java 11中文版 - API参考文档

API Reference Document

All Superinterfaces:

AttributeView ， FileAttributeView

All Known Subinterfaces:

AclFileAttributeView ， PosixFileAttributeView
```
public interface FileOwnerAttributeView
extends FileAttributeView
```
一个文件属性视图，支持读取或更新文件的所有者。此文件属性视图适用于支持文件属性的文件系统实现，该文件属性表示作为文件所有者的标识。通常，文件的所有者是创建该文件的实体的标识。
getOwner或setOwner方法可用于读取或更新文件的所有者。

getAttribute和setAttribute方法也可用于读取或更新所有者。在这种情况下，owner属性由名称"owner"标识，属性的值为UserPrincipal 。

从以下版本开始：

1.7

方法摘要

所有方法实例方法抽象方法
变量和类型	方法	描述
`UserPrincipal`	`getOwner()`	阅读文件所有者。
`String`	`name()`	返回属性视图的名称。
`void`	`setOwner(UserPrincipal owner)`	更新文件所有者。

- 方法详细信息
  - name
```
String name()
```
    返回属性视图的名称。此类型的属性视图的名称为"owner" 。
    
    Specified by:
    
    name在界面 AttributeView
    
    结果
    
    属性视图的名称
  - getOwner
```
UserPrincipal getOwner()
                throws IOException
```
    阅读文件所有者。
    如果文件所有者可以是group，则它是特定于实现的。
    
    结果
    
    文件所有者
    
    异常
    
    IOException - 如果发生I / O错误
    
    SecurityException - 对于默认提供程序，安装了安全管理器，它拒绝RuntimePermission ("accessUserInformation")或其checkRead方法拒绝对该文件的读访问权。
  - setOwner
```
void setOwner(UserPrincipal owner)
       throws IOException
```
    更新文件所有者。
    如果文件所有者可以是group，则它是特定于实现的。为了确保跨平台的一致和正确的行为，建议此方法仅用于将文件所有者设置为不是组的用户主体。
    
    参数
    
    owner - 新文件所有者
    
    异常
    
    IOException - 如果发生I / O错误，或者 owner参数是一个组，并且此实现不支持将所有者设置为组
    
    SecurityException - 对于默认提供程序，安装了安全管理器，它拒绝RuntimePermission ("accessUserInformation")或其checkWrite方法拒绝对该文件的写访问权。