180 lines
5.9 KiB
180 lines
5.9 KiB
/*
|
|
* Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
|
|
package java.nio.file.attribute;
|
|
|
|
import java.io.IOException;
|
|
|
|
/**
|
|
* A file attribute view that provides a view of the legacy "DOS" file attributes.
|
|
* These attributes are supported by file systems such as the File Allocation
|
|
* Table (FAT) format commonly used in <em>consumer devices</em>.
|
|
*
|
|
* <p> A {@code DosFileAttributeView} is a {@link BasicFileAttributeView} that
|
|
* additionally supports access to the set of DOS attribute flags that are used
|
|
* to indicate if the file is read-only, hidden, a system file, or archived.
|
|
*
|
|
* <p> Where dynamic access to file attributes is required, the attributes
|
|
* supported by this attribute view are as defined by {@code
|
|
* BasicFileAttributeView}, and in addition, the following attributes are
|
|
* supported:
|
|
* <blockquote>
|
|
* <table border="1" cellpadding="8" summary="Supported attributes">
|
|
* <tr>
|
|
* <th> Name </th>
|
|
* <th> Type </th>
|
|
* </tr>
|
|
* <tr>
|
|
* <td> readonly </td>
|
|
* <td> {@link Boolean} </td>
|
|
* </tr>
|
|
* <tr>
|
|
* <td> hidden </td>
|
|
* <td> {@link Boolean} </td>
|
|
* </tr>
|
|
* <tr>
|
|
* <td> system </td>
|
|
* <td> {@link Boolean} </td>
|
|
* </tr>
|
|
* <tr>
|
|
* <td> archive </td>
|
|
* <td> {@link Boolean} </td>
|
|
* </tr>
|
|
* </table>
|
|
* </blockquote>
|
|
*
|
|
* <p> The {@link java.nio.file.Files#getAttribute getAttribute} method may
|
|
* be used to read any of these attributes, or any of the attributes defined by
|
|
* {@link BasicFileAttributeView} as if by invoking the {@link #readAttributes
|
|
* readAttributes()} method.
|
|
*
|
|
* <p> The {@link java.nio.file.Files#setAttribute setAttribute} method may
|
|
* be used to update the file's last modified time, last access time or create
|
|
* time attributes as defined by {@link BasicFileAttributeView}. It may also be
|
|
* used to update the DOS attributes as if by invoking the {@link #setReadOnly
|
|
* setReadOnly}, {@link #setHidden setHidden}, {@link #setSystem setSystem}, and
|
|
* {@link #setArchive setArchive} methods respectively.
|
|
*
|
|
* @since 1.7
|
|
*/
|
|
|
|
public interface DosFileAttributeView
|
|
extends BasicFileAttributeView
|
|
{
|
|
/**
|
|
* Returns the name of the attribute view. Attribute views of this type
|
|
* have the name {@code "dos"}.
|
|
*/
|
|
@Override
|
|
String name();
|
|
|
|
/**
|
|
* @throws IOException {@inheritDoc}
|
|
* @throws SecurityException {@inheritDoc}
|
|
*/
|
|
@Override
|
|
DosFileAttributes readAttributes() throws IOException;
|
|
|
|
/**
|
|
* Updates the value of the read-only attribute.
|
|
*
|
|
* <p> It is implementation specific if the attribute can be updated as an
|
|
* atomic operation with respect to other file system operations. An
|
|
* implementation may, for example, require to read the existing value of
|
|
* the DOS attribute in order to update this attribute.
|
|
*
|
|
* @param value
|
|
* the new value of the attribute
|
|
*
|
|
* @throws IOException
|
|
* if an I/O error occurs
|
|
* @throws SecurityException
|
|
* In the case of the default, and a security manager is installed,
|
|
* its {@link SecurityManager#checkWrite(String) checkWrite} method
|
|
* is invoked to check write access to the file
|
|
*/
|
|
void setReadOnly(boolean value) throws IOException;
|
|
|
|
/**
|
|
* Updates the value of the hidden attribute.
|
|
*
|
|
* <p> It is implementation specific if the attribute can be updated as an
|
|
* atomic operation with respect to other file system operations. An
|
|
* implementation may, for example, require to read the existing value of
|
|
* the DOS attribute in order to update this attribute.
|
|
*
|
|
* @param value
|
|
* the new value of the attribute
|
|
*
|
|
* @throws IOException
|
|
* if an I/O error occurs
|
|
* @throws SecurityException
|
|
* In the case of the default, and a security manager is installed,
|
|
* its {@link SecurityManager#checkWrite(String) checkWrite} method
|
|
* is invoked to check write access to the file
|
|
*/
|
|
void setHidden(boolean value) throws IOException;
|
|
|
|
/**
|
|
* Updates the value of the system attribute.
|
|
*
|
|
* <p> It is implementation specific if the attribute can be updated as an
|
|
* atomic operation with respect to other file system operations. An
|
|
* implementation may, for example, require to read the existing value of
|
|
* the DOS attribute in order to update this attribute.
|
|
*
|
|
* @param value
|
|
* the new value of the attribute
|
|
*
|
|
* @throws IOException
|
|
* if an I/O error occurs
|
|
* @throws SecurityException
|
|
* In the case of the default, and a security manager is installed,
|
|
* its {@link SecurityManager#checkWrite(String) checkWrite} method
|
|
* is invoked to check write access to the file
|
|
*/
|
|
void setSystem(boolean value) throws IOException;
|
|
|
|
/**
|
|
* Updates the value of the archive attribute.
|
|
*
|
|
* <p> It is implementation specific if the attribute can be updated as an
|
|
* atomic operation with respect to other file system operations. An
|
|
* implementation may, for example, require to read the existing value of
|
|
* the DOS attribute in order to update this attribute.
|
|
*
|
|
* @param value
|
|
* the new value of the attribute
|
|
*
|
|
* @throws IOException
|
|
* if an I/O error occurs
|
|
* @throws SecurityException
|
|
* In the case of the default, and a security manager is installed,
|
|
* its {@link SecurityManager#checkWrite(String) checkWrite} method
|
|
* is invoked to check write access to the file
|
|
*/
|
|
void setArchive(boolean value) throws IOException;
|
|
}
|