FileOwnerAttributeView

public interface FileOwnerAttributeView implements FileAttributeView

Known Indirect Subclasses AclFileAttributeView, PosixFileAttributeView AclFileAttributeView A file attribute view that supports reading or updating a file's Access Control Lists (ACL) or file owner attributes.  PosixFileAttributeView A file attribute view that provides a view of the file attributes commonly associated with files on file systems used by operating systems that implement the Portable Operating System Interface (POSIX) family of standards.

A file attribute view that supports reading or updating the owner of a file. This file attribute view is intended for file system implementations that support a file attribute that represents an identity that is the owner of the file. Often the owner of a file is the identity of the entity that created the file.

The getOwner or setOwner methods may be used to read or update the owner of the file.

The getAttribute and setAttribute methods may also be used to read or update the owner. In that case, the owner attribute is identified by the name "owner", and the value of the attribute is a UserPrincipal.

Public Method Summary

abstract UserPrincipal	getOwner() Read the file owner.
abstract String	name() Returns the name of the attribute view.
abstract void	setOwner(UserPrincipal owner) Updates the file owner.

Inherited Method Summary

From interface java.nio.file.attribute.AttributeView

abstract String

name() Returns the name of the attribute view.

Public Methods

public abstract UserPrincipal getOwner ()

Read the file owner.

It it implementation specific if the file owner can be a group.

Returns

• the file owner

Throws

IOException	if an I/O error occurs
SecurityException	In the case of the default provider, a security manager is installed, and it denies RuntimePermission("accessUserInformation") or its checkRead method denies read access to the file.

public abstract String name ()

Returns the name of the attribute view. Attribute views of this type have the name "owner".

Returns

• the name of the attribute view

public abstract void setOwner (UserPrincipal owner)

Updates the file owner.

It it implementation specific if the file owner can be a group. To ensure consistent and correct behavior across platforms it is recommended that this method should only be used to set the file owner to a user principal that is not a group.

Parameters

owner	the new file owner

Throws

IOException	if an I/O error occurs, or the owner parameter is a group and this implementation does not support setting the owner to a group
SecurityException	In the case of the default provider, a security manager is installed, and it denies RuntimePermission("accessUserInformation") or its checkWrite method denies write access to the file.