Package org.apache.commons.vfs2.cache

Class SoftRefFilesCache

java.lang.Object

org.apache.commons.vfs2.provider.AbstractVfsComponent

org.apache.commons.vfs2.cache.AbstractFilesCache

org.apache.commons.vfs2.cache.SoftRefFilesCache

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, FilesCache, VfsComponent

Direct Known Subclasses:

WeakRefFilesCache

public class SoftRefFilesCache
extends AbstractFilesCache

This implementation caches every file as long as it is strongly reachable by the JVM. As soon as the JVM needs memory - every softly reachable file will be discarded.

See Also:

SoftReference

Constructor Summary

Constructors

Constructor	Description
SoftRefFilesCache()	Constructs a new instance.

Method Summary

Modifier and Type	Method	Description
void	clear(FileSystem fileSystem)	Purges the entries corresponding to the FileSystem.
void	close()	Closes the provider.
protected java.lang.ref.Reference<FileObject>	createReference(FileObject file, java.lang.ref.ReferenceQueue<FileObject> referenceQueue)	Constructs a new Reference.
FileObject	getFile(FileSystem fileSystem, FileName fileName)	Retrieves a FileObject from the cache by name.
protected java.util.Map<FileName,java.lang.ref.Reference<FileObject>>	getOrCreateFilesystemCache(FileSystem fileSystem)	Gets or creates a new Map.
void	putFile(FileObject fileObject)	Adds a FileObject to the cache.
boolean	putFileIfAbsent(FileObject fileObject)	Adds a FileObject to the cache if it isn't already present.
void	removeFile(FileSystem fileSystem, FileName fileName)	Removes a file from cache.
java.lang.String	toString()

Methods inherited from class org.apache.commons.vfs2.cache.AbstractFilesCache

touchFile

Methods inherited from class org.apache.commons.vfs2.provider.AbstractVfsComponent

getContext, getLogger, init, setContext, setLogger

Methods inherited from class java.lang.Object

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

Constructor Detail

SoftRefFilesCache

public SoftRefFilesCache()

Constructs a new instance.

Method Detail

clear

public void clear(FileSystem fileSystem)

Description copied from interface: FilesCache

Purges the entries corresponding to the FileSystem.

Parameters:

fileSystem - The FileSystem.

close

public void close()

Description copied from class: AbstractVfsComponent

Closes the provider. This implementation does nothing.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface FilesCache

Specified by:

close in interface VfsComponent

Overrides:

close in class AbstractVfsComponent

createReference

protected java.lang.ref.Reference<FileObject> createReference(FileObject file,
                                                              java.lang.ref.ReferenceQueue<FileObject> referenceQueue)

Constructs a new Reference.

Parameters:

file - a file object.

referenceQueue - a ReferenceQueue.

Returns:

a new Reference on the given input.

getFile

public FileObject getFile(FileSystem fileSystem,
                          FileName fileName)

Description copied from interface: FilesCache

Retrieves a FileObject from the cache by name.

Parameters:

fileSystem - The FileSystem.

fileName - the name

Returns:

the file object or null if file is not cached

getOrCreateFilesystemCache

protected java.util.Map<FileName,java.lang.ref.Reference<FileObject>> getOrCreateFilesystemCache(FileSystem fileSystem)

Gets or creates a new Map.

Parameters:

fileSystem - the key.

Returns:

an existing or new Map.

putFile

public void putFile(FileObject fileObject)

Description copied from interface: FilesCache

Adds a FileObject to the cache.

Parameters:

fileObject - the file

putFileIfAbsent

public boolean putFileIfAbsent(FileObject fileObject)

Description copied from interface: FilesCache

Adds a FileObject to the cache if it isn't already present.

Parameters:

fileObject - the file

Returns:

true if the file was stored, false otherwise.

removeFile

public void removeFile(FileSystem fileSystem,
                       FileName fileName)

Description copied from interface: FilesCache

Removes a file from cache.

Parameters:

fileSystem - file system

fileName - file name

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object