Apache Lucene.Net 2.4.0 Class Library API

SimpleFSLockFactory Class

Implements {@link LockFactory} using {@link File#createNewFile()}. This is the default LockFactory for {@link FSDirectory}.

NOTE: the javadocs for

File.createNewFile
contain a vague yet spooky warning about not using the API for file locking. This warning was added due to this bug, and in fact the only known problem with using this API for locking is that the Lucene write lock may not be released when the JVM exits abnormally.

When this happens, a {@link LockObtainFailedException} is hit when trying to create a writer, in which case you need to explicitly clear the lock file first. You can either manually remove the file, or use the {@link Lucene.Net.Index.IndexReader#Unlock(Directory)} API. But, first be certain that no writer is in fact writing to the index otherwise you can easily corrupt your index.

If you suspect that this or any other LockFactory is not working properly in your environment, you can easily test it by using {@link VerifyingLockFactory}, {@link LockVerifyServer} and {@link LockStressTest}.

For a list of all members of this type, see SimpleFSLockFactory Members.

System.Object
   Lucene.Net.Store.LockFactory
      Lucene.Net.Store.SimpleFSLockFactory

public class SimpleFSLockFactory : LockFactory

Thread Safety

Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.

Requirements

Namespace: Lucene.Net.Store

Assembly: Lucene.Net (in Lucene.Net.dll)

See Also

SimpleFSLockFactory Members | Lucene.Net.Store Namespace |