net.java.truevfs.access

Class TFileSystem

java.lang.Object

java.nio.file.FileSystem

net.java.truevfs.access.TFileSystem

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

@ThreadSafe
public final class TFileSystem
extends java.nio.file.FileSystem

A FileSystem implementation for use with NIO.2.

Method Summary

Modifier and Type	Method and Description
void	close() Commits all pending changes for this (federated) file system and all its federated child file systems to their respective parent file system, closes their associated target (archive) file in order to allow access by third parties (e.g. other processes), cleans up any temporary allocated resources (e.g. temporary files) and purges any cached data.
java.lang.Iterable<java.nio.file.FileStore>	getFileStores()
TPath	getPath(java.lang.String first, java.lang.String... more) Constructs a new path from the given sub path strings.
java.nio.file.PathMatcher	getPathMatcher(java.lang.String syntaxAndPattern)
java.lang.Iterable<java.nio.file.Path>	getRootDirectories()
java.lang.String	getSeparator() Returns File.separator.
java.nio.file.attribute.UserPrincipalLookupService	getUserPrincipalLookupService()
boolean	isOpen() Returns true.
boolean	isReadOnly() Returns false.
java.nio.file.WatchService	newWatchService()
TFileSystemProvider	provider()
java.util.Set<java.lang.String>	supportedFileAttributeViews()
void	sync(net.java.truecommons.shed.BitField<net.java.truevfs.kernel.spec.FsSyncOption> options) Commits all pending changes for this (federated) file system and all its federated child file systems to their respective parent file system with respect to the given options.

Methods inherited from class java.lang.Object

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

Method Detail

provider

public TFileSystemProvider provider()

Specified by:

provider in class java.nio.file.FileSystem

close

public void close()
           throws net.java.truevfs.kernel.spec.FsSyncWarningException,
                  net.java.truevfs.kernel.spec.FsSyncException

Commits all pending changes for this (federated) file system and all its federated child file systems to their respective parent file system, closes their associated target (archive) file in order to allow access by third parties (e.g. other processes), cleans up any temporary allocated resources (e.g. temporary files) and purges any cached data.

Calling this method is equivalent to sync(FsSyncOptions.UMOUNT).

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class java.nio.file.FileSystem

Throws:

net.java.truevfs.kernel.spec.FsSyncWarningException - if only warning conditions apply. This implies that the respective parent file system has been synchronized with constraints, e.g. if an unclosed archive entry stream gets forcibly closed.

net.java.truevfs.kernel.spec.FsSyncException - if any error conditions apply. This implies some loss of data!

See Also:

sync(BitField)

sync

public void sync(net.java.truecommons.shed.BitField<net.java.truevfs.kernel.spec.FsSyncOption> options)
          throws net.java.truevfs.kernel.spec.FsSyncWarningException,
                 net.java.truevfs.kernel.spec.FsSyncException

Commits all pending changes for this (federated) file system and all its federated child file systems to their respective parent file system with respect to the given options.

Parameters:

options - a bit field of options for the synchronization operation.

Throws:

java.lang.IllegalArgumentException - if the combination of synchronization options is illegal, e.g. if FsSyncOption.FORCE_CLOSE_INPUT is cleared and FsSyncOption.FORCE_CLOSE_OUTPUT is set or if FsSyncOption.ABORT_CHANGES is set.

net.java.truevfs.kernel.spec.FsSyncWarningException - if only warning conditions apply. This implies that the respective parent file system has been synchronized with constraints, e.g. if FsSyncOption.FORCE_CLOSE_INPUT or FsSyncOption.FORCE_CLOSE_OUTPUT is set and an unclosed archive entry stream gets forcibly closed.

net.java.truevfs.kernel.spec.FsSyncException - if any error conditions apply. This implies some loss of data!

isOpen

public boolean isOpen()

Returns true.

Specified by:

isOpen in class java.nio.file.FileSystem

Returns:

true.

isReadOnly

public boolean isReadOnly()

Returns false.

Specified by:

isReadOnly in class java.nio.file.FileSystem

Returns:

false.

getSeparator

public java.lang.String getSeparator()

Returns File.separator.

Specified by:

getSeparator in class java.nio.file.FileSystem

Returns:

File.separator.

getRootDirectories

public java.lang.Iterable<java.nio.file.Path> getRootDirectories()

Specified by:

getRootDirectories in class java.nio.file.FileSystem

getFileStores

public java.lang.Iterable<java.nio.file.FileStore> getFileStores()

Specified by:

getFileStores in class java.nio.file.FileSystem

Throws:

java.lang.UnsupportedOperationException - always

supportedFileAttributeViews

public java.util.Set<java.lang.String> supportedFileAttributeViews()

Specified by:

supportedFileAttributeViews in class java.nio.file.FileSystem

getPath

public TPath getPath(java.lang.String first,
                     java.lang.String... more)

Constructs a new path from the given sub path strings.

This method scans the path name resulting from the segment parameters to detect prospective archive files using the current archive detector TConfig.current().getArchiveDetector().

The supported path name separators are "File.separator" and "/". Any leading and trailing separators in the resulting path name current discarded.

Specified by:

getPath in class java.nio.file.FileSystem

Parameters:

first - the first sub path string.

more - optional sub path strings.

getPathMatcher

public java.nio.file.PathMatcher getPathMatcher(java.lang.String syntaxAndPattern)

Specified by:

getPathMatcher in class java.nio.file.FileSystem

Throws:

java.lang.UnsupportedOperationException - always

getUserPrincipalLookupService

public java.nio.file.attribute.UserPrincipalLookupService getUserPrincipalLookupService()

Specified by:

getUserPrincipalLookupService in class java.nio.file.FileSystem

Throws:

java.lang.UnsupportedOperationException - always

newWatchService

public java.nio.file.WatchService newWatchService()
                                           throws java.io.IOException

Specified by:

newWatchService in class java.nio.file.FileSystem

Throws:

java.lang.UnsupportedOperationException - always

java.io.IOException