Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.
Java™ Platform
Standard Ed. 7

DRAFT ea-b123

Package java.nio.file.attribute

Interfaces and classes providing access to file and file system attributes.

See: Description

Package java.nio.file.attribute Description

Interfaces and classes providing access to file and file system attributes.

Attribute views

Description

AttributeView Can read or update non-opaque values associated with objects in a file system
  FileAttributeView Can read or update file attributes
    BasicFileAttributeView   Can read or update a basic set of file attributes
      PosixFileAttributeView   Can read or update POSIX defined file attributes
      DosFileAttributeView   Can read or update FAT file attributes
    FileOwnerAttributeView   Can read or update the owner of a file
     AclFileAttributeView   Can read or update Access Control Lists
    UserDefinedFileAttributeView   Can read or update user-defined file attributes
  FileStoreAttributeView Can read or update file system attributes
    FileStoreSpaceAttributeView   Can read file system space usage related attributes

An attribute view provides a read-only or updatable view of the non-opaque values, or metadata, associated with objects in a file system. The FileAttributeView interface is extended by several other interfaces that that views to specific sets of file attributes. FileAttributeViews are selected by invoking the FileRef.getFileAttributeView(java.lang.Class, java.nio.file.LinkOption...) method with a type-token to identify the required view. Views can also be identified by name. The FileStoreAttributeView interface provides access to file store attributes. A FileStoreAttributeView of a given type is obtained by invoking the FileStore.getFileStoreAttributeView(java.lang.Class) method.

The BasicFileAttributeView class defines methods to read and update a basic set of file attributes that are common to many file systems.

The PosixFileAttributeView interface extends BasicFileAttributeView by defining methods to access the file attributes commonly used by file systems and operating systems that implement the Portable Operating System Interface (POSIX) family of standards.

The DosFileAttributeView class extends BasicFileAttributeView by defining methods to access the legacy "DOS" file attributes supported on file systems such as File Allocation Tabl (FAT), commonly used in consumer devices.

The AclFileAttributeView class defines methods to read and write the Access Control List (ACL) file attribute. The ACL model used by this file attribute view is based on the model defined by RFC 3530: Network File System (NFS) version 4 Protocol.

The FileStoreSpaceAttributeView class defines methods to read file system space usage related attributes of a file system.

The Attributes utility class defines static methods to access file or file system attribute using the above attribute views.

In addition to attribute views, this package also defines classes and interfaces that are used when accessing attributes:

Unless otherwise noted, passing a null argument to a constructor or method in any class or interface in this package will cause a NullPointerException to be thrown.

Since:
1.7
Java™ Platform
Standard Ed. 7

DRAFT ea-b123

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle Corporation. All rights reserved.
DRAFT ea-b123