alluxio.client.file

Class CachingFileSystem

java.lang.Object

alluxio.client.file.BaseFileSystem

alluxio.client.file.CachingFileSystem

All Implemented Interfaces:

FileSystem, Closeable, AutoCloseable

@ThreadSafe
public class CachingFileSystem
extends BaseFileSystem

FileSystem implementation with the capability of caching metadata of paths.

Nested Class Summary

Nested classes/interfaces inherited from interface alluxio.client.file.FileSystem

FileSystem.Cache, FileSystem.Factory, FileSystem.FileSystemKey

Field Summary

Fields inherited from class alluxio.client.file.BaseFileSystem

mBlockStore, mCachingEnabled, mClosed, mFsContext

Constructor Summary

Constructors

Constructor and Description
CachingFileSystem(FileSystemContext context, boolean cachingEnabled)

Method Summary

Modifier and Type	Method and Description
void	asyncUpdateFileAccessTime(AlluxioURI path) Asynchronously update file's last access time.
void	close() Shuts down the FileSystem.
URIStatus	getStatus(AlluxioURI path, GetStatusPOptions options) Gets the URIStatus object that represents the metadata of an Alluxio path.
List<URIStatus>	listStatus(AlluxioURI path, ListStatusPOptions options) If the path is a directory, returns the URIStatus of all the direct entries in it.

Methods inherited from class alluxio.client.file.BaseFileSystem

checkUri, create, create, createDirectory, createDirectory, createFile, createFile, delete, delete, exists, exists, free, free, getBlockLocations, getConf, getMountTable, getStatus, getSyncPathList, isClosed, listStatus, mount, mount, openFile, openFile, persist, persist, rename, rename, reverseResolve, setAcl, setAcl, setAttribute, setAttribute, startSync, stopSync, unmount, unmount, updateMount

Methods inherited from class java.lang.Object

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

Constructor Detail

CachingFileSystem

public CachingFileSystem(FileSystemContext context,
                         boolean cachingEnabled)

Parameters:

context - the fs context

cachingEnabled - enables caching

Method Detail

getStatus

public URIStatus getStatus(AlluxioURI path,
                           GetStatusPOptions options)
                    throws FileDoesNotExistException,
                           IOException,
                           AlluxioException

Description copied from interface: FileSystem

Gets the URIStatus object that represents the metadata of an Alluxio path.

Specified by:

getStatus in interface FileSystem

Overrides:

getStatus in class BaseFileSystem

Parameters:

path - the path to obtain information about

options - options to associate with this operation

Returns:

the URIStatus of the file

Throws:

FileDoesNotExistException - if the path does not exist

IOException

AlluxioException

listStatus

public List<URIStatus> listStatus(AlluxioURI path,
                                  ListStatusPOptions options)
                           throws FileDoesNotExistException,
                                  IOException,
                                  AlluxioException

Description copied from interface: FileSystem

If the path is a directory, returns the URIStatus of all the direct entries in it. Otherwise returns a list with a single URIStatus element for the file.

Specified by:

listStatus in interface FileSystem

Overrides:

listStatus in class BaseFileSystem

Parameters:

path - the path to list information about

options - options to associate with this operation

Returns:

a list of URIStatuss containing information about the files and directories which are children of the given path

Throws:

FileDoesNotExistException - if the given path does not exist

IOException

AlluxioException

asyncUpdateFileAccessTime

public void asyncUpdateFileAccessTime(AlluxioURI path)

Asynchronously update file's last access time.

Parameters:

path - the path to the file

close

public void close()
           throws IOException

Description copied from class: BaseFileSystem

Shuts down the FileSystem. Closes all thread pools and resources used to perform operations. If any operations are called after closing the context the behavior is undefined.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class BaseFileSystem

Throws:

IOException