org.apache.lucene.index

Class RandomIndexWriter

java.lang.Object

org.apache.lucene.index.RandomIndexWriter

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class RandomIndexWriter
extends java.lang.Object
implements java.io.Closeable

Silly class that randomizes the indexing experience. EG it may swap in a different merge policy/scheduler; may commit periodically; may or may not forceMerge in the end, may flush by doc count instead of RAM, etc.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	RandomIndexWriter.TestPoint Simple interface that is executed for each TP InfoStream component message.

Field Summary

Fields

Modifier and Type	Field and Description
IndexWriter	w

Constructor Summary

Constructors

Constructor and Description
RandomIndexWriter(java.util.Random r, Directory dir) create a RandomIndexWriter with a random config: Uses MockAnalyzer
RandomIndexWriter(java.util.Random r, Directory dir, Analyzer a) create a RandomIndexWriter with a random config
RandomIndexWriter(java.util.Random r, Directory dir, IndexWriterConfig c) create a RandomIndexWriter with the provided config
RandomIndexWriter(java.util.Random r, Directory dir, IndexWriterConfig c, boolean useSoftDeletes) create a RandomIndexWriter with the provided config

Method Summary

Modifier and Type	Method and Description
<T extends IndexableField> long	addDocument(java.lang.Iterable<T> doc) Adds a Document.
long	addDocuments(java.lang.Iterable<? extends java.lang.Iterable<? extends IndexableField>> docs)
long	addIndexes(CodecReader... readers)
long	addIndexes(Directory... dirs)
void	close() Close this writer.
long	commit()
long	deleteAll()
long	deleteDocuments(Query q)
long	deleteDocuments(Term term)
void	flush() Writes all in-memory segments to the Directory.
void	forceMerge(int maxSegmentCount) Forces a forceMerge.
void	forceMergeDeletes()
void	forceMergeDeletes(boolean doWait)
IndexWriter.DocStats	getDocStats()
DirectoryReader	getReader()
DirectoryReader	getReader(boolean applyDeletions, boolean writeAllDeletes)
static IndexWriter	mockIndexWriter(Directory dir, IndexWriterConfig conf, java.util.Random r) Returns an indexwriter that randomly mixes up thread scheduling (by yielding at test points)
static IndexWriter	mockIndexWriter(java.util.Random r, Directory dir, IndexWriterConfig conf, RandomIndexWriter.TestPoint testPoint) Returns an indexwriter that enables the specified test point
void	setDoRandomForceMerge(boolean v)
void	setDoRandomForceMergeAssert(boolean v)
long	updateBinaryDocValue(Term term, java.lang.String field, BytesRef value)
<T extends IndexableField> long	updateDocument(Term t, java.lang.Iterable<T> doc) Updates a document.
long	updateDocuments(Term delTerm, java.lang.Iterable<? extends java.lang.Iterable<? extends IndexableField>> docs)
long	updateDocValues(Term term, Field... updates)
long	updateNumericDocValue(Term term, java.lang.String field, java.lang.Long value)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

w

public final IndexWriter w

Constructor Detail

RandomIndexWriter

public RandomIndexWriter(java.util.Random r,
                         Directory dir)
                  throws java.io.IOException

create a RandomIndexWriter with a random config: Uses MockAnalyzer

Throws:

java.io.IOException

RandomIndexWriter

public RandomIndexWriter(java.util.Random r,
                         Directory dir,
                         Analyzer a)
                  throws java.io.IOException

create a RandomIndexWriter with a random config

Throws:

java.io.IOException

RandomIndexWriter

public RandomIndexWriter(java.util.Random r,
                         Directory dir,
                         IndexWriterConfig c)
                  throws java.io.IOException

create a RandomIndexWriter with the provided config

Throws:

java.io.IOException

RandomIndexWriter

public RandomIndexWriter(java.util.Random r,
                         Directory dir,
                         IndexWriterConfig c,
                         boolean useSoftDeletes)
                  throws java.io.IOException

create a RandomIndexWriter with the provided config

Throws:

java.io.IOException

Method Detail

mockIndexWriter

public static IndexWriter mockIndexWriter(Directory dir,
                                          IndexWriterConfig conf,
                                          java.util.Random r)
                                   throws java.io.IOException

Returns an indexwriter that randomly mixes up thread scheduling (by yielding at test points)

Throws:

java.io.IOException

mockIndexWriter

public static IndexWriter mockIndexWriter(java.util.Random r,
                                          Directory dir,
                                          IndexWriterConfig conf,
                                          RandomIndexWriter.TestPoint testPoint)
                                   throws java.io.IOException

Returns an indexwriter that enables the specified test point

Throws:

java.io.IOException

addDocument

public <T extends IndexableField> long addDocument(java.lang.Iterable<T> doc)
                                            throws java.io.IOException

Adds a Document.

Throws:

java.io.IOException

See Also:

IndexWriter.addDocument(Iterable)

addDocuments

public long addDocuments(java.lang.Iterable<? extends java.lang.Iterable<? extends IndexableField>> docs)
                  throws java.io.IOException

Throws:

java.io.IOException

updateDocuments

public long updateDocuments(Term delTerm,
                            java.lang.Iterable<? extends java.lang.Iterable<? extends IndexableField>> docs)
                     throws java.io.IOException

Throws:

java.io.IOException

updateDocument

public <T extends IndexableField> long updateDocument(Term t,
                                                      java.lang.Iterable<T> doc)
                                               throws java.io.IOException

Updates a document.

Throws:

java.io.IOException

See Also:

IndexWriter.updateDocument(Term, Iterable)

addIndexes

public long addIndexes(Directory... dirs)
                throws java.io.IOException

Throws:

java.io.IOException

addIndexes

public long addIndexes(CodecReader... readers)
                throws java.io.IOException

Throws:

java.io.IOException

updateNumericDocValue

public long updateNumericDocValue(Term term,
                                  java.lang.String field,
                                  java.lang.Long value)
                           throws java.io.IOException

Throws:

java.io.IOException

updateBinaryDocValue

public long updateBinaryDocValue(Term term,
                                 java.lang.String field,
                                 BytesRef value)
                          throws java.io.IOException

Throws:

java.io.IOException

updateDocValues

public long updateDocValues(Term term,
                            Field... updates)
                     throws java.io.IOException

Throws:

java.io.IOException

deleteDocuments

public long deleteDocuments(Term term)
                     throws java.io.IOException

Throws:

java.io.IOException

deleteDocuments

public long deleteDocuments(Query q)
                     throws java.io.IOException

Throws:

java.io.IOException

commit

public long commit()
            throws java.io.IOException

Throws:

java.io.IOException

getDocStats

public IndexWriter.DocStats getDocStats()

deleteAll

public long deleteAll()
               throws java.io.IOException

Throws:

java.io.IOException

getReader

public DirectoryReader getReader()
                          throws java.io.IOException

Throws:

java.io.IOException

forceMergeDeletes

public void forceMergeDeletes(boolean doWait)
                       throws java.io.IOException

Throws:

java.io.IOException

forceMergeDeletes

public void forceMergeDeletes()
                       throws java.io.IOException

Throws:

java.io.IOException

setDoRandomForceMerge

public void setDoRandomForceMerge(boolean v)

setDoRandomForceMergeAssert

public void setDoRandomForceMergeAssert(boolean v)

getReader

public DirectoryReader getReader(boolean applyDeletions,
                                 boolean writeAllDeletes)
                          throws java.io.IOException

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Close this writer.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

See Also:

IndexWriter.close()

forceMerge

public void forceMerge(int maxSegmentCount)
                throws java.io.IOException

Forces a forceMerge.

NOTE: this should be avoided in tests unless absolutely necessary, as it will result in less test coverage.

Throws:

java.io.IOException

See Also:

IndexWriter.forceMerge(int)

flush

public final void flush()
                 throws java.io.IOException

Writes all in-memory segments to the Directory.

Throws:

java.io.IOException