Package org.jboss.vfs.spi
Class RealFileSystem
java.lang.Object
org.jboss.vfs.spi.RealFileSystem
- All Implemented Interfaces:
Closeable
,AutoCloseable
,FileSystem
A real filesystem.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final boolean
private final boolean
private final File
-
Constructor Summary
ConstructorsConstructorDescriptionRealFileSystem
(File realRoot) Construct a real filesystem with the given real root.RealFileSystem
(File realRoot, boolean privileged) Construct a real filesystem with the given real root. -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Destroy this filesystem instance.boolean
delete
(VirtualFile mountPoint, VirtualFile target) Attempt to delete a virtual file within this filesystem.private static <T> T
doIoPrivileged
(PrivilegedExceptionAction<T> action) boolean
exists
(VirtualFile mountPoint, VirtualFile target) Ascertain the existance of a virtual file within this filesystem.getCodeSigners
(VirtualFile mountPoint, VirtualFile target) Get theCodeSigner
s for a the virtual file.getDirectoryEntries
(VirtualFile mountPoint, VirtualFile target) Read a directory.getFile
(VirtualFile mountPoint, VirtualFile target) Get a realFile
for the given path within this filesystem.long
getLastModified
(VirtualFile mountPoint, VirtualFile target) Get the last modification time of a virtual file within this filesystem.Get theFile
source provided at mount time.Get the root URI for this file system, ornull
if there is no valid root URI.long
getSize
(VirtualFile mountPoint, VirtualFile target) Get the size of a virtual file within this filesystem.boolean
isDirectory
(VirtualFile mountPoint, VirtualFile target) Ascertain whether a virtual file within this filesystem is a directory.boolean
isFile
(VirtualFile mountPoint, VirtualFile target) Ascertain whether a virtual file within this filesystem is a plain file.boolean
Determine whether this filesystem is read-only.openInputStream
(VirtualFile mountPoint, VirtualFile target) Open an input stream for the file at the given relative path.
-
Field Details
-
NEEDS_CONVERSION
private static final boolean NEEDS_CONVERSION -
realRoot
-
privileged
private final boolean privileged
-
-
Constructor Details
-
RealFileSystem
Construct a real filesystem with the given real root.- Parameters:
realRoot
- the real root
-
RealFileSystem
Construct a real filesystem with the given real root.- Parameters:
realRoot
- the real rootprivileged
-true
to check permissions once up front,false
to check at access time
-
-
Method Details
-
doIoPrivileged
- Throws:
IOException
-
openInputStream
Open an input stream for the file at the given relative path.- Specified by:
openInputStream
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
- the input stream
- Throws:
IOException
- if an I/O error occurs
-
isReadOnly
public boolean isReadOnly()Determine whether this filesystem is read-only. A read-only filesystem prohibits file modification or deletion. It is not an error to mount a read-write filesystem within a read-only filesystem however (this operation does not take place within theFileSystem
implementation).- Specified by:
isReadOnly
in interfaceFileSystem
- Returns:
true
if the filesystem is read-only
-
getFile
Get a realFile
for the given path within this filesystem. Some filesystem types will need to make a copy in order to return this file; such copies should be cached and retained until the filesystem is closed. Depending on the file type, the real path of the returnedFile
may or may not bear a relationship to the virtual path provided; if such a relationship is required, it must be negotiated at the time the filesystem is mounted.- Specified by:
getFile
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
- the file instance
-
delete
Attempt to delete a virtual file within this filesystem.- Specified by:
delete
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
true
if the file was deleted,false
if it failed for any reason
-
getSize
Get the size of a virtual file within this filesystem.- Specified by:
getSize
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
- the size, in bytes, or 0L if the file does not exist or is a directory
-
getLastModified
Get the last modification time of a virtual file within this filesystem.- Specified by:
getLastModified
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
- the modification time in milliseconds, or 0L if the file does not exist or if an error occurs
-
exists
Ascertain the existance of a virtual file within this filesystem.- Specified by:
exists
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
true
if the file exists,false
otherwise
-
isFile
Ascertain whether a virtual file within this filesystem is a plain file.- Specified by:
isFile
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
true
if the file exists and is a plain file,false
otherwise
-
isDirectory
Ascertain whether a virtual file within this filesystem is a directory.- Specified by:
isDirectory
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
true
if the file exists and is a directory,false
otherwise
-
getDirectoryEntries
Read a directory. Returns all the simple path names (excluding "." and ".."). The returned list will be empty if the node is not a directory.- Specified by:
getDirectoryEntries
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
- the collection of children names
-
getCodeSigners
Get theCodeSigner
s for a the virtual file.- Specified by:
getCodeSigners
in interfaceFileSystem
- Parameters:
mountPoint
- the mount point of the filesystem instance (guaranteed to be a parent oftarget
)target
- the virtual file to act upon- Returns:
CodeSigner
for the virtual file or null if not signed.
-
getMountSource
Get theFile
source provided at mount time.- Specified by:
getMountSource
in interfaceFileSystem
- Returns:
- the source used for mounting
-
getRootURI
Description copied from interface:FileSystem
Get the root URI for this file system, ornull
if there is no valid root URI.- Specified by:
getRootURI
in interfaceFileSystem
- Returns:
- the root URI
- Throws:
URISyntaxException
- if the URI isn't valid
-
close
Destroy this filesystem instance. After this method is called, the filesystem may not be used in any way. This method should be called only after all mounts of this filesystem have been cleared; otherwise, VFS accesses may result inIOException
s.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceFileSystem
- Throws:
IOException
- if an I/O error occurs during close
-