java.nio.file.attribute

  • This document details interfaces, classes, enums, and exceptions related to file attributes in Java NIO.2.

  • It covers views for file attributes like ACLs, basic attributes, DOS attributes, file ownership, and POSIX attributes.

  • It describes how to work with access control lists (ACLs) through AclEntry, AclEntry.Builder, and related enums.

  • PosixFilePermissions provides methods for handling POSIX file permissions, and UserPrincipalLookupService helps find user and group principals.

  • A UserPrincipalNotFoundException is thrown when a user or group principal cannot be found during a lookup.

Interfaces

AclFileAttributeView A file attribute view that supports reading or updating a file's Access Control Lists (ACL) or file owner attributes. 
AttributeView An object that provides a read-only or updatable view of non-opaque values associated with an object in a filesystem. 
BasicFileAttributes Basic attributes associated with a file in a file system. 
BasicFileAttributeView A file attribute view that provides a view of a basic set of file attributes common to many file systems. 
DosFileAttributes File attributes associated with a file in a file system that supports legacy "DOS" attributes. 
DosFileAttributeView A file attribute view that provides a view of the legacy "DOS" file attributes. 
FileAttribute<T> An object that encapsulates the value of a file attribute that can be set atomically when creating a new file or directory by invoking the createFile or createDirectory methods. 
FileAttributeView An attribute view that is a read-only or updatable view of non-opaque values associated with a file in a filesystem. 
FileOwnerAttributeView A file attribute view that supports reading or updating the owner of a file. 
FileStoreAttributeView An attribute view that is a read-only or updatable view of the attributes of a FileStore. 
GroupPrincipal A UserPrincipal representing a group identity, used to determine access rights to objects in a file system. 
PosixFileAttributes File attributes associated with files on file systems used by operating systems that implement the Portable Operating System Interface (POSIX) family of standards. 
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. 
UserDefinedFileAttributeView A file attribute view that provides a view of a file's user-defined attributes, sometimes known as extended attributes. 
UserPrincipal A Principal representing an identity used to determine access rights to objects in a file system. 

Classes

AclEntry An entry in an access control list (ACL). 
AclEntry.Builder A builder of AclEntry objects. 
PosixFilePermissions This class consists exclusively of static methods that operate on sets of PosixFilePermission objects. 
UserPrincipalLookupService An object to lookup user and group principals by name. 

Enums

AclEntryFlag Defines the flags for used by the flags component of an ACL entry. 
AclEntryPermission Defines the permissions for use with the permissions component of an ACL entry. 
AclEntryType A typesafe enumeration of the access control entry types. 
PosixFilePermission Defines the bits for use with the permissions attribute. 

Exceptions

UserPrincipalNotFoundException Checked exception thrown when a lookup of UserPrincipal fails because the principal does not exist.