java.lang.Object | |
↳ | org.apache.lucene.store.Directory |
Known Direct Subclasses |
Known Indirect Subclasses |
A Directory is a flat list of files. Files may be written once, when they are created. Once a file is created it may only be opened for read, or deleted. Random access is permitted both when reading and writing.
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(LockFactory)
.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
isOpen | |||||||||||
lockFactory | Holds the LockFactory instance (implements locking for this Directory instance). |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Attempt to clear (forcefully unlock and remove) the
specified lock.
| |||||||||||
Closes the store.
| |||||||||||
Copy contents of a directory src to a directory dest.
| |||||||||||
Creates a new, empty file in the directory with the given name.
| |||||||||||
Removes an existing file in the directory.
| |||||||||||
Returns true iff a file with the given name exists.
| |||||||||||
Returns the length of a file in the directory.
| |||||||||||
Returns the time the named file was last modified.
| |||||||||||
Get the LockFactory that this Directory instance is
using for its locking implementation.
| |||||||||||
Return a string identifier that uniquely differentiates
this Directory instance from other Directory instances.
| |||||||||||
Returns an array of strings, one for each file in the
directory.
| |||||||||||
Construct a
Lock . | |||||||||||
Returns a stream reading an existing file, with the
specified read buffer size.
| |||||||||||
Returns a stream reading an existing file.
| |||||||||||
Set the LockFactory that this Directory instance should
use for its locking implementation.
| |||||||||||
Ensure that any writes to this file are moved to
stable storage.
| |||||||||||
Set the modified time of an existing file to now.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
java.io.Closeable
|
Holds the LockFactory instance (implements locking for this Directory instance).
Attempt to clear (forcefully unlock and remove) the specified lock. Only call this at a time when you are certain this lock is no longer in use.
name | name of the lock to be cleared. |
---|
IOException |
---|
Copy contents of a directory src to a directory dest. If a file in src already exists in dest then the one in dest will be blindly overwritten.
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 directory |
---|---|
dest | destination directory |
closeDirSrc | if true , call close() method on source directory |
IOException |
---|
Creates a new, empty file in the directory with the given name. Returns a stream writing this file.
IOException |
---|
Removes an existing file in the directory.
IOException |
---|
Returns true iff a file with the given name exists.
IOException |
---|
Returns the length of a file in the directory.
IOException |
---|
Returns the time the named file was last modified.
IOException |
---|
Get the LockFactory that this Directory instance is using for its locking implementation. Note that this may be null for Directory implementations that provide their own locking implementation.
Return a string identifier that uniquely differentiates this Directory instance from other Directory instances. This ID should be the same if two Directory instances (even in different JVMs and/or on different machines) are considered "the same index". This is how locking "scopes" to the right index.
Returns an array of strings, one for each file in the directory.
IOException |
---|
Returns a stream reading an existing file, with the
specified read buffer size. The particular Directory
implementation may ignore the buffer size. Currently
the only Directory implementations that respect this
parameter are FSDirectory
and org.apache.lucene.index.CompoundFileReader.
IOException |
---|
Returns a stream reading an existing file.
IOException |
---|
Set the LockFactory that this Directory instance should use for its locking implementation. Each * instance of LockFactory should only be used for one directory (ie, do not share a single instance across multiple Directories).
lockFactory | instance of LockFactory .
|
---|
Ensure that any writes to this file are moved to stable storage. Lucene uses this to properly commit changes to the index, to prevent a machine/OS crash from corrupting the index.
IOException |
---|
Set the modified time of an existing file to now.
IOException |
---|