com.github.fge.filesystem.attributes.provider

Class PosixFileAttributesProvider

java.lang.Object

com.github.fge.filesystem.attributes.provider.FileAttributesProvider

com.github.fge.filesystem.attributes.provider.PosixFileAttributesProvider

All Implemented Interfaces:

AttributeView, BasicFileAttributes, BasicFileAttributeView, FileAttributeView, FileOwnerAttributeView, PosixFileAttributes, PosixFileAttributeView

@ParametersAreNonnullByDefault
public abstract class PosixFileAttributesProvider
extends FileAttributesProvider
implements PosixFileAttributeView, PosixFileAttributes

Provider for the "posix" file attribute view

The default values are the same as BasicFileAttributesProvider; in addition, the default permissions are "rwxr-wr-x" for directories and rw-r--r-- for all other types.

See Also:

PosixFileAttributeView, PosixFileAttributes, PosixFilePermissions

Field Summary

Fields

Modifier and Type	Field and Description
protected static Set<PosixFilePermission>	DEFAULT_DIRECTORY_PERMS
protected static Set<PosixFilePermission>	DEFAULT_OTHER_PERMS
protected static FileTime	UNIX_EPOCH

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PosixFileAttributesProvider()

Method Summary

Methods

Modifier and Type	Method and Description
FileTime	creationTime()
Object	fileKey()
Map<String,Object>	getAllAttributes() Get all attributes for this view
Object	getAttributeByName(String name) Get an attribute value by name
boolean	isOther()
boolean	isSymbolicLink()
FileTime	lastAccessTime()
FileTime	lastModifiedTime()
Set<PosixFilePermission>	permissions()
PosixFileAttributes	readAttributes()
void	setAttributeByName(String name, Object value) Set one attribute by name
void	setGroup(GroupPrincipal group)
void	setOwner(UserPrincipal owner)
void	setPermissions(Set<PosixFilePermission> perms)
void	setTimes(FileTime lastModifiedTime, FileTime lastAccessTime, FileTime createTime)

Methods inherited from class com.github.fge.filesystem.attributes.provider.FileAttributesProvider

name

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.nio.file.attribute.PosixFileAttributeView

name

Methods inherited from interface java.nio.file.attribute.FileOwnerAttributeView

getOwner

Methods inherited from interface java.nio.file.attribute.PosixFileAttributes

group, owner

Methods inherited from interface java.nio.file.attribute.BasicFileAttributes

isDirectory, isRegularFile, size

Field Detail

UNIX_EPOCH

protected static final FileTime UNIX_EPOCH

DEFAULT_OTHER_PERMS

protected static final Set<PosixFilePermission> DEFAULT_OTHER_PERMS

DEFAULT_DIRECTORY_PERMS

protected static final Set<PosixFilePermission> DEFAULT_DIRECTORY_PERMS

Constructor Detail

PosixFileAttributesProvider

protected PosixFileAttributesProvider()
                               throws IOException

Throws:

IOException

Method Detail

readAttributes

public final PosixFileAttributes readAttributes()
                                         throws IOException

Specified by:

readAttributes in interface BasicFileAttributeView

Specified by:

readAttributes in interface PosixFileAttributeView

Throws:

IOException

lastModifiedTime

public FileTime lastModifiedTime()

Specified by:

lastModifiedTime in interface BasicFileAttributes

lastAccessTime

public FileTime lastAccessTime()

Specified by:

lastAccessTime in interface BasicFileAttributes

creationTime

public FileTime creationTime()

Specified by:

creationTime in interface BasicFileAttributes

isSymbolicLink

public boolean isSymbolicLink()

Specified by:

isSymbolicLink in interface BasicFileAttributes

isOther

public boolean isOther()

Specified by:

isOther in interface BasicFileAttributes

fileKey

public Object fileKey()

Specified by:

fileKey in interface BasicFileAttributes

permissions

public Set<PosixFilePermission> permissions()

Specified by:

permissions in interface PosixFileAttributes

setTimes

public void setTimes(@Nullable
            FileTime lastModifiedTime,
            @Nullable
            FileTime lastAccessTime,
            @Nullable
            FileTime createTime)
              throws IOException

Specified by:

setTimes in interface BasicFileAttributeView

Throws:

IOException

setOwner

public void setOwner(UserPrincipal owner)
              throws IOException

Specified by:

setOwner in interface FileOwnerAttributeView

Throws:

IOException

setGroup

public void setGroup(GroupPrincipal group)
              throws IOException

Specified by:

setGroup in interface PosixFileAttributeView

Throws:

IOException

setPermissions

public void setPermissions(Set<PosixFilePermission> perms)
                    throws IOException

Specified by:

setPermissions in interface PosixFileAttributeView

Throws:

IOException

setAttributeByName

public void setAttributeByName(String name,
                      Object value)
                        throws IOException

Description copied from class: FileAttributesProvider

Set one attribute by name

Specified by:

setAttributeByName in class FileAttributesProvider

Parameters:

name - the name of the attribute

value - the value of the attribute

Throws:

IOException - I/O error when trying to set the attribute

ReadOnlyAttributeException - the attribute is read only

getAttributeByName

@Nonnull
public Object getAttributeByName(String name)
                          throws IOException

Description copied from class: FileAttributesProvider

Get an attribute value by name

Specified by:

getAttributeByName in class FileAttributesProvider

Parameters:

name - the name of the attribute

Returns:

the value of this attribute

Throws:

IOException - I/O error when trying to set the attribute

getAllAttributes

@Nonnull
public final Map<String,Object> getAllAttributes()
                                          throws IOException

Description copied from class: FileAttributesProvider

Get all attributes for this view

The returned map will have the attribute names as keys and their values as values. The returned map must be immutable (use Collections.unmodifiableMap(Map) for instance).

The order of keys in the returned map is not guaranteed.

Specified by:

getAllAttributes in class FileAttributesProvider

Returns:

an immutable map of all attribute name/value pairs

Throws:

IOException - failure to read one or more attributes