jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java
changeset 46147 047bdc4d771d
parent 45437 c48b8edad8dd
equal deleted inserted replaced
46146:b3e220a04d3f 46147:047bdc4d771d
     1 /*
     1 /*
     2  * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2007, 2017, 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
    24  */
    24  */
    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 class="borderless">
    29  * <table class="striped" style="padding-left:2em; text-align:left">
    30  *     <caption style="display:none">Attribute views</caption>
    30  *     <caption style="display:none">Attribute views</caption>
    31  * <tr><th style="text-align:left">Attribute views</th>
    31  * <thead>
    32  *     <th style="text-align:left">Description</th></tr>
    32  * <tr><th scope="col">Attribute views</th>
    33  * <tr><td><i>{@link java.nio.file.attribute.AttributeView}</i></td>
    33  *     <th scope="col">Description</th></tr>
       
    34  * </thead>
       
    35  * <tbody>
       
    36  * <tr><th scope="row"><i>{@link java.nio.file.attribute.AttributeView}</i></th>
    34  *     <td>Can read or update non-opaque values associated with objects in a file system</td></tr>
    37  *     <td>Can read or update non-opaque values associated with objects in a file system</td></tr>
    35  * <tr><td style="vertical-align:top">
    38  * <tr><th scope="row">
    36  *     &nbsp;&nbsp;<i>{@link java.nio.file.attribute.FileAttributeView}</i></td>
    39  *     <span style="padding-left:1em"><i>{@link java.nio.file.attribute.FileAttributeView}</i></span></th>
    37  *     <td>Can read or update file attributes</td></tr>
    40  *     <td>Can read or update file attributes</td></tr>
    38  * <tr><td style="vertical-align:top">
    41  * <tr><th scope="row">
    39  *     &nbsp;&nbsp;&nbsp;&nbsp;
    42  *     <span style="padding-left:2em">
    40  *     <i>{@link java.nio.file.attribute.BasicFileAttributeView}&nbsp;&nbsp;</i></td>
    43  *     <i>{@link java.nio.file.attribute.BasicFileAttributeView}</i></span></th>
    41  *     <td>Can read or update a basic set of file attributes</td></tr>
    44  *     <td>Can read or update a basic set of file attributes</td></tr>
    42  * <tr><td style="vertical-align:top">
    45  * <tr><th scope="row">
    43  *     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    46  *     <span style="padding-left:3em">
    44  *     <i>{@link java.nio.file.attribute.PosixFileAttributeView}&nbsp;&nbsp;</i></td>
    47  *     <i>{@link java.nio.file.attribute.PosixFileAttributeView}</i></span></th>
    45  *     <td>Can read or update POSIX defined file attributes</td></tr>
    48  *     <td>Can read or update POSIX defined file attributes</td></tr>
    46  * <tr><td style="vertical-align:top">
    49  * <tr><th scope="row">
    47  *     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    50  *     <span style="padding-left:3em">
    48  *     <i>{@link java.nio.file.attribute.DosFileAttributeView}&nbsp;&nbsp;</i></td>
    51  *     <i>{@link java.nio.file.attribute.DosFileAttributeView}</i></span></th>
    49  *     <td>Can read or update FAT file attributes</td></tr>
    52  *     <td>Can read or update FAT file attributes</td></tr>
    50  * <tr><td style="vertical-align:top">
    53  * <tr><th scope="row">
    51  *     &nbsp;&nbsp;&nbsp;&nbsp;
    54  *     <span style="padding-left:2em">
    52  *     <i>{@link java.nio.file.attribute.FileOwnerAttributeView}&nbsp;&nbsp;</i></td>
    55  *     <i>{@link java.nio.file.attribute.FileOwnerAttributeView}</i></span></th>
    53  *     <td>Can read or update the owner of a file</td></tr>
    56  *     <td>Can read or update the owner of a file</td></tr>
    54  * <tr><td style="vertical-align:top">
    57  * <tr><th scope="row">
    55  *     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    58  *     <span style="padding-left:3em">
    56  *     <i>{@link java.nio.file.attribute.AclFileAttributeView}&nbsp;&nbsp;</i></td>
    59  *     <i>{@link java.nio.file.attribute.AclFileAttributeView}</i></span></th>
    57  *     <td>Can read or update Access Control Lists</td></tr>
    60  *     <td>Can read or update Access Control Lists</td></tr>
    58  * <tr><td style="vertical-align:top">
    61  * <tr><th scope="row">
    59  *     &nbsp;&nbsp;&nbsp;&nbsp;
    62  *     <span style="padding-left:2em">
    60  *     <i>{@link java.nio.file.attribute.UserDefinedFileAttributeView}&nbsp;&nbsp;</i></td>
    63  *     <i>{@link java.nio.file.attribute.UserDefinedFileAttributeView}</i></span></th>
    61  *     <td>Can read or update user-defined file attributes</td></tr>
    64  *     <td>Can read or update user-defined file attributes</td></tr>
    62  * <tr><td style="vertical-align:top">
    65  * <tr><th scope="row">
    63  *     &nbsp;&nbsp;<i>{@link java.nio.file.attribute.FileStoreAttributeView}</i></td>
    66  *     <span style="padding-left:1em"><i>{@link java.nio.file.attribute.FileStoreAttributeView}</i></span></th>
    64  *     <td>Can read or update file system attributes</td></tr>
    67  *     <td>Can read or update file system attributes</td></tr>
    65  * </table></blockquote>
    68  * </tbody>
       
    69  * </table>
    66  *
    70  *
    67  * <p> An attribute view provides a read-only or updatable view of the non-opaque
    71  * <p> An attribute view provides a read-only or updatable view of the non-opaque
    68  * values, or <em>metadata</em>, associated with objects in a file system.
    72  * values, or <em>metadata</em>, associated with objects in a file system.
    69  * The {@link java.nio.file.attribute.FileAttributeView} interface is
    73  * The {@link java.nio.file.attribute.FileAttributeView} interface is
    70  * extended by several other interfaces that provide views to specific sets of file
    74  * extended by several other interfaces that provide views to specific sets of file