org.apache.solr.core

Class StandardDirectoryFactory

java.lang.Object

org.apache.solr.core.DirectoryFactory

org.apache.solr.core.CachingDirectoryFactory

org.apache.solr.core.StandardDirectoryFactory

All Implemented Interfaces:

Closeable, NamedListInitializedPlugin

Direct Known Subclasses:

MMapDirectoryFactory, NIOFSDirectoryFactory, NRTCachingDirectoryFactory, SimpleFSDirectoryFactory

public class StandardDirectoryFactory
extends CachingDirectoryFactory

Directory provider which mimics original Solr FSDirectory based behavior. File based DirectoryFactory implementations generally extend this class.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.solr.core.CachingDirectoryFactory

CachingDirectoryFactory.CacheValue, CachingDirectoryFactory.CloseListener

Nested classes/interfaces inherited from class org.apache.solr.core.DirectoryFactory

DirectoryFactory.DirContext

Field Summary

Fields inherited from class org.apache.solr.core.CachingDirectoryFactory

byDirectoryCache, byPathCache, closeListeners

Fields inherited from class org.apache.solr.core.DirectoryFactory

IOCONTEXT_NO_CACHE

Constructor Summary

Constructors

Constructor and Description
StandardDirectoryFactory()

Method Summary

Methods

Modifier and Type	Method and Description
protected Directory	create(String path, DirectoryFactory.DirContext dirContext) Creates a new Directory for a given path.
boolean	isPersistent()
void	move(Directory fromDir, Directory toDir, String fileName, IOContext ioContext) Override for more efficient moves.
String	normalize(String path) Normalize a given path.
void	remove(Directory dir) Removes the Directory's persistent storage.
void	remove(String path) This remove is special in that it may be called even after the factory has been closed.

Methods inherited from class org.apache.solr.core.CachingDirectoryFactory

addCloseListener, close, doneWithDirectory, exists, get, get, incRef, init, release

Methods inherited from class org.apache.solr.core.DirectoryFactory

empty, sizeOf, sizeOfDirectory

Methods inherited from class java.lang.Object

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

Constructor Detail

StandardDirectoryFactory

public StandardDirectoryFactory()

Method Detail

create

protected Directory create(String path,
               DirectoryFactory.DirContext dirContext)
                    throws IOException

Description copied from class: DirectoryFactory

Creates a new Directory for a given path.

Specified by:

create in class CachingDirectoryFactory

Throws:

IOException - If there is a low-level I/O error.

normalize

public String normalize(String path)
                 throws IOException

Description copied from class: DirectoryFactory

Normalize a given path.

Overrides:

normalize in class DirectoryFactory

Parameters:

path - to normalize

Returns:

normalized path

Throws:

IOException - on io error

isPersistent

public boolean isPersistent()

Specified by:

isPersistent in class DirectoryFactory

Returns:

true if data is kept after close.

remove

public void remove(Directory dir)
            throws IOException

Description copied from class: DirectoryFactory

Removes the Directory's persistent storage. For example: A file system impl may remove the on disk directory.

Specified by:

remove in class DirectoryFactory

Throws:

IOException - If there is a low-level I/O error.

remove

public void remove(String path)
            throws IOException

Description copied from class: DirectoryFactory

This remove is special in that it may be called even after the factory has been closed. Remove only makes sense for persistent directory factories.

Specified by:

remove in class DirectoryFactory

Parameters:

path - to remove

Throws:

IOException - If there is a low-level I/O error.

move

public void move(Directory fromDir,
        Directory toDir,
        String fileName,
        IOContext ioContext)
          throws IOException

Override for more efficient moves. Intended for use with replication - use carefully - some Directory wrappers will cache files for example. This implementation works with two wrappers: NRTCachingDirectory and RateLimitedDirectoryWrapper. You should first Directory.sync(java.util.Collection) any file that will be moved or avoid cached files through settings.

Overrides:

move in class DirectoryFactory

Throws:

IOException - If there is a low-level I/O error.