1 /* |
1 /* |
2 * Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
25 |
25 |
26 /** |
26 /** |
27 * Interfaces and classes providing access to file and file system attributes. |
27 * Interfaces and classes providing access to file and file system attributes. |
28 * |
28 * |
29 * <blockquote><table cellspacing=1 cellpadding=0 summary="Attribute views"> |
29 * <blockquote><table cellspacing=1 cellpadding=0 summary="Attribute views"> |
30 * <tr><th><p align="left">Attribute views</p></th><th><p align="left">Description</p></th></tr> |
30 * <tr><th align="left">Attribute views</th><th align="left">Description</th></tr> |
31 * <tr><td valign=top><tt><i>{@link java.nio.file.attribute.AttributeView}</i></tt></td> |
31 * <tr><td valign=top><tt><i>{@link java.nio.file.attribute.AttributeView}</i></tt></td> |
32 * <td>Can read or update non-opaque values associated with objects in a file system</td></tr> |
32 * <td>Can read or update non-opaque values associated with objects in a file system</td></tr> |
33 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.FileAttributeView}</i></tt></td> |
33 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.FileAttributeView}</i></tt></td> |
34 * <td>Can read or update file attributes</td></tr> |
34 * <td>Can read or update file attributes</td></tr> |
35 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.BasicFileAttributeView} </i></tt></td> |
35 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.BasicFileAttributeView} </i></tt></td> |
36 * <td>Can read or update a basic set of file attributes</td></tr> |
36 * <td>Can read or update a basic set of file attributes</td></tr> |
37 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.PosixFileAttributeView} </i></tt></td> |
37 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.PosixFileAttributeView} </i></tt></td> |
38 * <td>Can read or update POSIX defined file attributes</td></tr> |
38 * <td>Can read or update POSIX defined file attributes</td></tr> |
39 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.DosFileAttributeView} </i></tt></td> |
39 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.DosFileAttributeView} </i></tt></td> |
40 * <td>Can read or update FAT file attributes</td></tr> |
40 * <td>Can read or update FAT file attributes</td></tr> |
41 * <tr><td valign=top><tt>  <i>{@link java.nio.file.attribute.FileOwnerAttributeView} </i></tt></td> |
41 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.FileOwnerAttributeView} </i></tt></td> |
42 * <td>Can read or update the owner of a file</td></tr> |
42 * <td>Can read or update the owner of a file</td></tr> |
43 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.AclFileAttributeView} </i></tt></td> |
43 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.AclFileAttributeView} </i></tt></td> |
44 * <td>Can read or update Access Control Lists</td></tr> |
44 * <td>Can read or update Access Control Lists</td></tr> |
45 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.UserDefinedFileAttributeView} </i></tt></td> |
45 * <tr><td valign=top><tt> <i>{@link java.nio.file.attribute.UserDefinedFileAttributeView} </i></tt></td> |
46 * <td>Can read or update user-defined file attributes</td></tr> |
46 * <td>Can read or update user-defined file attributes</td></tr> |
84 * <p> In addition to attribute views, this package also defines classes and |
84 * <p> In addition to attribute views, this package also defines classes and |
85 * interfaces that are used when accessing attributes: |
85 * interfaces that are used when accessing attributes: |
86 * |
86 * |
87 * <ul> |
87 * <ul> |
88 * |
88 * |
89 * <p><li> The {@link java.nio.file.attribute.UserPrincipal} and |
89 * <li> The {@link java.nio.file.attribute.UserPrincipal} and |
90 * {@link java.nio.file.attribute.GroupPrincipal} interfaces represent an |
90 * {@link java.nio.file.attribute.GroupPrincipal} interfaces represent an |
91 * identity or group identity. </li> |
91 * identity or group identity. </li> |
92 * |
92 * |
93 * <p><li> The {@link java.nio.file.attribute.UserPrincipalLookupService} |
93 * <li> The {@link java.nio.file.attribute.UserPrincipalLookupService} |
94 * interface defines methods to lookup user or group principals. </li> |
94 * interface defines methods to lookup user or group principals. </li> |
95 * |
95 * |
96 * <p><li> The {@link java.nio.file.attribute.FileAttribute} interface |
96 * <li> The {@link java.nio.file.attribute.FileAttribute} interface |
97 * represents the value of an attribute for cases where the attribute value is |
97 * represents the value of an attribute for cases where the attribute value is |
98 * required to be set atomically when creating an object in the file system. </li> |
98 * required to be set atomically when creating an object in the file system. </li> |
99 * |
99 * |
100 * </ul> |
100 * </ul> |
101 * |
101 * |