public abstract class Directory
extends java.lang.Object
Java's i/o APIs not used directly, but rather all i/o is through this API. This permits things such as:
LockFactory
, and can be changed for each Directory
instance using setLockFactory(org.apache.lucene.store.LockFactory)
.Modifier and Type | Field and Description |
---|---|
protected boolean |
isOpen |
protected LockFactory |
lockFactory
Holds the LockFactory instance (implements locking for
this Directory instance).
|
Constructor and Description |
---|
Directory() |
Modifier and Type | Method and Description |
---|---|
void |
clearLock(java.lang.String name)
Attempt to clear (forcefully unlock and remove) the
specified lock.
|
abstract void |
close()
Closes the store.
|
static void |
copy(Directory src,
Directory dest,
boolean closeDirSrc)
Copy contents of a directory src to a directory dest.
|
abstract IndexOutput |
createOutput(java.lang.String name)
Creates a new, empty file in the directory with the given name.
|
abstract void |
deleteFile(java.lang.String name)
Removes an existing file in the directory.
|
protected void |
ensureOpen() |
abstract boolean |
fileExists(java.lang.String name)
Returns true iff a file with the given name exists.
|
abstract long |
fileLength(java.lang.String name)
Returns the length of a file in the directory.
|
abstract long |
fileModified(java.lang.String name)
Returns the time the named file was last modified.
|
LockFactory |
getLockFactory()
Get the LockFactory that this Directory instance is
using for its locking implementation.
|
java.lang.String |
getLockID()
Return a string identifier that uniquely differentiates
this Directory instance from other Directory instances.
|
abstract java.lang.String[] |
list()
Deprecated.
For some Directory implementations (
FSDirectory , and its subclasses), this method
silently filters its results to include only index
files. Please use listAll() instead, which
does no filtering. |
java.lang.String[] |
listAll()
Returns an array of strings, one for each file in the
directory.
|
Lock |
makeLock(java.lang.String name)
Construct a
Lock . |
abstract IndexInput |
openInput(java.lang.String name)
Returns a stream reading an existing file.
|
IndexInput |
openInput(java.lang.String name,
int bufferSize)
Returns a stream reading an existing file, with the
specified read buffer size.
|
abstract void |
renameFile(java.lang.String from,
java.lang.String to)
Deprecated.
|
void |
setLockFactory(LockFactory lockFactory)
Set the LockFactory that this Directory instance should
use for its locking implementation.
|
void |
sync(java.lang.String name)
Ensure that any writes to this file are moved to
stable storage.
|
java.lang.String |
toString() |
abstract void |
touchFile(java.lang.String name)
Set the modified time of an existing file to now.
|
protected volatile boolean isOpen
protected LockFactory lockFactory
public abstract java.lang.String[] list() throws java.io.IOException
FSDirectory
, and its subclasses), this method
silently filters its results to include only index
files. Please use listAll()
instead, which
does no filtering.java.io.IOException
public java.lang.String[] listAll() throws java.io.IOException
list()
this method does no
filtering of the contents in a directory, and it will
never return null (throws IOException instead).
Currently this method simply falls back to list()
for Directory impls outside of Lucene's core &
contrib, but in 3.0 that method will be removed and
this method will become abstract.java.io.IOException
public abstract boolean fileExists(java.lang.String name) throws java.io.IOException
java.io.IOException
public abstract long fileModified(java.lang.String name) throws java.io.IOException
java.io.IOException
public abstract void touchFile(java.lang.String name) throws java.io.IOException
java.io.IOException
public abstract void deleteFile(java.lang.String name) throws java.io.IOException
java.io.IOException
public abstract void renameFile(java.lang.String from, java.lang.String to) throws java.io.IOException
java.io.IOException
public abstract long fileLength(java.lang.String name) throws java.io.IOException
java.io.IOException
public abstract IndexOutput createOutput(java.lang.String name) throws java.io.IOException
java.io.IOException
public void sync(java.lang.String name) throws java.io.IOException
java.io.IOException
public abstract IndexInput openInput(java.lang.String name) throws java.io.IOException
java.io.IOException
public IndexInput openInput(java.lang.String name, int bufferSize) throws java.io.IOException
FSDirectory
and CompoundFileReader
.java.io.IOException
public Lock makeLock(java.lang.String name)
Lock
.name
- the name of the lock filepublic void clearLock(java.lang.String name) throws java.io.IOException
name
- name of the lock to be cleared.java.io.IOException
public abstract void close() throws java.io.IOException
java.io.IOException
public void setLockFactory(LockFactory lockFactory)
lockFactory
- instance of LockFactory
.public LockFactory getLockFactory()
public java.lang.String getLockID()
public java.lang.String toString()
toString
in class java.lang.Object
public static void copy(Directory src, Directory dest, boolean closeDirSrc) throws java.io.IOException
NOTE: the source directory cannot change while this method is running. Otherwise the results are undefined and you could easily hit a FileNotFoundException.
NOTE: this method only copies files that look like index files (ie, have extensions matching the known extensions of index files).
src
- source directorydest
- destination directorycloseDirSrc
- if true
, call close()
method on source directoryjava.io.IOException
protected final void ensureOpen() throws AlreadyClosedException
AlreadyClosedException
- if this Directory is closedCopyright © 2000-2016 Apache Software Foundation. All Rights Reserved.