|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.lucene.index.IndexDeletionPolicy org.apache.lucene.index.SnapshotDeletionPolicy
public class SnapshotDeletionPolicy
An IndexDeletionPolicy
that wraps any other
IndexDeletionPolicy
and adds the ability to hold and later release
snapshots of an index. While a snapshot is held, the IndexWriter
will
not remove any files associated with it even if the index is otherwise being
actively, arbitrarily changed. Because we wrap another arbitrary
IndexDeletionPolicy
, this gives you the freedom to continue using
whatever IndexDeletionPolicy
you would normally want to use with your
index.
This class maintains all snapshots in-memory, and so the information is not
persisted and not protected against system failures. If persistence is
important, you can use PersistentSnapshotDeletionPolicy
.
Field Summary | |
---|---|
protected Map<Long,IndexCommit> |
indexCommits
Used to map gen to IndexCommit. |
protected IndexCommit |
lastCommit
Most recently committed IndexCommit . |
protected Map<Long,Integer> |
refCounts
Records how many snapshots are held against each commit generation |
Constructor Summary | |
---|---|
SnapshotDeletionPolicy(IndexDeletionPolicy primary)
Sole constructor, taking the incoming IndexDeletionPolicy to wrap. |
Method Summary | |
---|---|
IndexDeletionPolicy |
clone()
|
IndexCommit |
getIndexCommit(long gen)
Retrieve an IndexCommit from its generation;
returns null if this IndexCommit is not currently
snapshotted |
int |
getSnapshotCount()
Returns the total number of snapshots currently held. |
List<IndexCommit> |
getSnapshots()
Returns all IndexCommits held by at least one snapshot. |
protected void |
incRef(IndexCommit ic)
Increments the refCount for this IndexCommit . |
void |
onCommit(List<? extends IndexCommit> commits)
This is called each time the writer completed a commit. |
void |
onInit(List<? extends IndexCommit> commits)
This is called once when a writer is first instantiated to give the policy a chance to remove old commit points. |
void |
release(IndexCommit commit)
Release a snapshotted commit. |
protected void |
releaseGen(long gen)
Release a snapshot by generation. |
IndexCommit |
snapshot()
Snapshots the last commit and returns it. |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected Map<Long,Integer> refCounts
protected Map<Long,IndexCommit> indexCommits
protected IndexCommit lastCommit
IndexCommit
.
Constructor Detail |
---|
public SnapshotDeletionPolicy(IndexDeletionPolicy primary)
IndexDeletionPolicy
to wrap.
Method Detail |
---|
public void onCommit(List<? extends IndexCommit> commits) throws IOException
IndexDeletionPolicy
This is called each time the writer completed a commit. This gives the policy a chance to remove old commit points with each commit.
The policy may now choose to delete old commit points
by calling method delete()
of IndexCommit
.
This method is only called when IndexWriter.commit()
or IndexWriter.close()
is
called, or possibly not at all if the IndexWriter.rollback()
is called.
Note: the last CommitPoint is the most recent one, i.e. the "front index state". Be careful not to delete it, unless you know for sure what you are doing, and unless you can afford to lose the index content while doing that.
onCommit
in class IndexDeletionPolicy
commits
- List of IndexCommit
,
sorted by age (the 0th one is the oldest commit).
IOException
public void onInit(List<? extends IndexCommit> commits) throws IOException
IndexDeletionPolicy
This is called once when a writer is first instantiated to give the policy a chance to remove old commit points.
The writer locates all index commits present in the
index directory and calls this method. The policy may
choose to delete some of the commit points, doing so by
calling method delete()
of IndexCommit
.
Note: the last CommitPoint is the most recent one, i.e. the "front index state". Be careful not to delete it, unless you know for sure what you are doing, and unless you can afford to lose the index content while doing that.
onInit
in class IndexDeletionPolicy
commits
- List of current
point-in-time commits
,
sorted by age (the 0th one is the oldest commit).
Note that for a new index this method is invoked with
an empty list.
IOException
public void release(IndexCommit commit) throws IOException
commit
- the commit previously returned by snapshot()
IOException
protected void releaseGen(long gen) throws IOException
IOException
protected void incRef(IndexCommit ic)
IndexCommit
.
public IndexCommit snapshot() throws IOException
IndexDeletionPolicy
is used). The
snapshot can be removed by calling release(IndexCommit)
followed
by a call to IndexWriter.deleteUnusedFiles()
.
NOTE: while the snapshot is held, the files it references will not be deleted, which will consume additional disk space in your index. If you take a snapshot at a particularly bad time (say just before you call forceMerge) then in the worst case this could consume an extra 1X of your total index size, until you release the snapshot.
IndexCommit
that was snapshotted.
IllegalStateException
- if this index does not have any commits yet
IOException
public List<IndexCommit> getSnapshots()
public int getSnapshotCount()
public IndexCommit getIndexCommit(long gen)
IndexCommit
from its generation;
returns null if this IndexCommit is not currently
snapshotted
public IndexDeletionPolicy clone()
clone
in class IndexDeletionPolicy
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |