public abstract class LockFactory extends Object
Base class for Locking implementation. Directory
uses
instances of this class to implement locking.
Lucene uses NativeFSLockFactory
by default for
FSDirectory
-based index directories.
Special care needs to be taken if you change the locking implementation: First be certain that no writer is in fact writing to the index otherwise you can easily corrupt your index. Be sure to do the LockFactory change on all Lucene instances and clean up all leftover lock files before starting the new configuration for the first time. Different implementations can not work together!
If you suspect that some LockFactory implementation is
not working properly in your environment, you can easily
test it by using VerifyingLockFactory
, LockVerifyServer
and LockStressTest
.
LockVerifyServer
,
LockStressTest
,
VerifyingLockFactory
Constructor and Description |
---|
LockFactory() |
Modifier and Type | Method and Description |
---|---|
abstract Lock |
obtainLock(Directory dir,
String lockName)
Return a new obtained Lock instance identified by lockName.
|
public abstract Lock obtainLock(Directory dir, String lockName) throws IOException
lockName
- name of the lock to be created.LockObtainFailedException
- (optional specific exception) if the lock could
not be obtained because it is currently held elsewhere.IOException
- if any i/o error occurs attempting to gain the lockCopyright © 2000-2017 Apache Software Foundation. All Rights Reserved.