-
- All Superinterfaces:
- AttributeView, BasicFileAttributeView, FileAttributeView
public interface DosFileAttributeView extends BasicFileAttributeView
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 consumer devices.A
DosFileAttributeViewis aBasicFileAttributeViewthat 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.Where dynamic access to file attributes is required, the attributes supported by this attribute view are as defined by
BasicFileAttributeView, and in addition, the following attributes are supported:Name Type readonly Booleanhidden Booleansystem Booleanarchive BooleanThe
getAttributemethod may be used to read any of these attributes, or any of the attributes defined byBasicFileAttributeViewas if by invoking thereadAttributes()method.The
setAttributemethod may be used to update the file's last modified time, last access time or create time attributes as defined byBasicFileAttributeView. It may also be used to update the DOS attributes as if by invoking thesetReadOnly,setHidden,setSystem, andsetArchivemethods respectively.- Since:
- 1.7
-
-
Method Summary
Methods Modifier and Type Method and Description Stringname()Returns the name of the attribute view.DosFileAttributesreadAttributes()Reads the basic file attributes as a bulk operation.voidsetArchive(boolean value)Updates the value of the archive attribute.voidsetHidden(boolean value)Updates the value of the hidden attribute.voidsetReadOnly(boolean value)Updates the value of the read-only attribute.voidsetSystem(boolean value)Updates the value of the system attribute.-
Methods inherited from interface java.nio.file.attribute.BasicFileAttributeView
setTimes
-
-
-
-
Method Detail
-
name
String name()
Returns the name of the attribute view. Attribute views of this type have the name"dos".- Specified by:
namein interfaceAttributeView- Specified by:
namein interfaceBasicFileAttributeView
-
readAttributes
DosFileAttributes readAttributes() throws IOException
Description copied from interface:BasicFileAttributeViewReads the basic file attributes as a bulk operation.It is implementation specific if all file attributes are read as an atomic operation with respect to other file system operations.
- Specified by:
readAttributesin interfaceBasicFileAttributeView- Returns:
- the file attributes
- Throws:
IOException- if an I/O error occursSecurityException- In the case of the default provider, a security manager is installed, itscheckReadmethod is invoked to check read access to the file
-
setReadOnly
void setReadOnly(boolean value) throws IOExceptionUpdates the value of the read-only attribute.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.
- Parameters:
value- the new value of the attribute- Throws:
IOException- if an I/O error occursSecurityException- In the case of the default, and a security manager is installed, itscheckWritemethod is invoked to check write access to the file
-
setHidden
void setHidden(boolean value) throws IOExceptionUpdates the value of the hidden attribute.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.
- Parameters:
value- the new value of the attribute- Throws:
IOException- if an I/O error occursSecurityException- In the case of the default, and a security manager is installed, itscheckWritemethod is invoked to check write access to the file
-
setSystem
void setSystem(boolean value) throws IOExceptionUpdates the value of the system attribute.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.
- Parameters:
value- the new value of the attribute- Throws:
IOException- if an I/O error occursSecurityException- In the case of the default, and a security manager is installed, itscheckWritemethod is invoked to check write access to the file
-
setArchive
void setArchive(boolean value) throws IOExceptionUpdates the value of the archive attribute.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.
- Parameters:
value- the new value of the attribute- Throws:
IOException- if an I/O error occursSecurityException- In the case of the default, and a security manager is installed, itscheckWritemethod is invoked to check write access to the file
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/nio/file/attribute/DosFileAttributeView.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.
