org.apache.lucene.index

Class BasePostingsFormatTestCase

java.lang.Object

org.junit.Assert

org.apache.lucene.util.LuceneTestCase

org.apache.lucene.index.BasePostingsFormatTestCase

public abstract class BasePostingsFormatTestCase
extends LuceneTestCase

Abstract class to do basic tests for a postings format. NOTE: This test focuses on the postings (docs/freqs/positions/payloads/offsets) impl, not the terms dict. The [stretch] goal is for this test to be so thorough in testing a new PostingsFormat that if this test passes, then all Lucene/Solr tests should also pass. Ie, if there is some bug in a given PostingsFormat that this test fails to catch then this test needs to be improved!

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.lucene.util.LuceneTestCase

LuceneTestCase.AwaitsFix, LuceneTestCase.BadApple, LuceneTestCase.Monster, LuceneTestCase.Nightly, LuceneTestCase.Slow, LuceneTestCase.SuppressCodecs, LuceneTestCase.SuppressFileSystems, LuceneTestCase.SuppressFsync, LuceneTestCase.SuppressReproduceLine, LuceneTestCase.SuppressSysoutChecks, LuceneTestCase.SuppressTempFileChecks, LuceneTestCase.Weekly

Field Summary

Fields inherited from class org.apache.lucene.util.LuceneTestCase

assertsAreEnabled, classRules, DEFAULT_LINE_DOCS_FILE, INFOSTREAM, JENKINS_LARGE_LINE_DOCS_FILE, LEAVE_TEMPORARY, MAYBE_CACHE_POLICY, RANDOM_MULTIPLIER, ruleChain, suiteFailureMarker, SYSPROP_AWAITSFIX, SYSPROP_BADAPPLES, SYSPROP_FAILFAST, SYSPROP_MAXFAILURES, SYSPROP_MONSTER, SYSPROP_NIGHTLY, SYSPROP_SLOW, SYSPROP_WEEKLY, TEST_ASSERTS_ENABLED, TEST_AWAITSFIX, TEST_CODEC, TEST_DIRECTORY, TEST_DOCVALUESFORMAT, TEST_LINE_DOCS_FILE, TEST_NIGHTLY, TEST_POSTINGSFORMAT, TEST_SLOW, TEST_THROTTLING, TEST_WEEKLY, VERBOSE

Constructor Summary

Constructors

Constructor and Description
BasePostingsFormatTestCase()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addRandomFields(Document doc) Add random fields to the provided document.
static void	afterClass()
protected void	assertReused(String field, PostingsEnum p1, PostingsEnum p2)
protected static void	checkReuse(TermsEnum termsEnum, int firstFlags, int secondFlags, boolean shouldReuse)
static void	createPostings()
protected Collection<String>	excludedExtensionsFromByteCounts() Return the list of extensions that should be excluded from byte counts when comparing indices that store the same content.
protected abstract Codec	getCodec() Returns the codec to run tests against
protected boolean	isPostingsEnumReuseImplemented()
void	setUp() For subclasses to override.
void	tearDown() For subclasses to override.
void	testAskForPositionsWhenNotThere()
void	testDidntWantFreqsButAskedAnyway()
void	testDocsAndFreqs()
void	testDocsAndFreqsAndPositions()
void	testDocsAndFreqsAndPositionsAndOffsets()
void	testDocsAndFreqsAndPositionsAndOffsetsAndPayloads()
void	testDocsAndFreqsAndPositionsAndPayloads()
void	testDocsOnly()
void	testEmptyFieldAndEmptyTerm()
void	testGhosts()
void	testInvertedWrite()
void	testJustEmptyField()
void	testLegacyEnumAll() Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.
void	testLegacyEnumDocsOnly() Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.
void	testLegacyEnumFreqs() Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.
void	testLegacyEnumOffsets() Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.
void	testLegacyEnumPayloads() Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.
void	testLegacyEnumPositions() Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.
void	testMergeStability() The purpose of this test is to make sure that bulk merge doesn't accumulate useless data over runs.
void	testMultiClose() Calls close multiple times on closeable codec apis
void	testPostingsEnumAll()
void	testPostingsEnumDocsOnly()
void	testPostingsEnumFreqs()
void	testPostingsEnumOffsets()
void	testPostingsEnumPayloads()
void	testPostingsEnumPositions()
void	testPostingsEnumReuse()
void	testRamBytesUsed() Test the accuracy of the ramBytesUsed estimations.
void	testRandom()
void	testRandomExceptions() Tests exception handling on write and openInput/createOutput

Methods inherited from class org.apache.lucene.util.LuceneTestCase

assertDeletedDocsEquals, assertDocsAndPositionsEnumEquals, assertDocsEnumEquals, assertDocsSkippingEquals, assertDocValuesEquals, assertDocValuesEquals, assertFieldInfosEquals, assertFieldsEquals, assertFieldStatisticsEquals, assertNormsEquals, assertPositionsSkippingEquals, assertReaderEquals, assertReaderStatisticsEquals, assertStoredFieldEquals, assertStoredFieldsEquals, assertTermsEnumEquals, assertTermsEquals, assertTermsStatisticsEquals, assertTermStatsEquals, assertTermVectorsEquals, asSet, assumeFalse, assumeNoException, assumeTrue, atLeast, atLeast, closeAfterSuite, closeAfterTest, collate, createTempDir, createTempDir, createTempFile, createTempFile, dumpArray, dumpIterator, getBaseTempDirForTestClass, getDataInputStream, getDataPath, getOnlySegmentReader, getTestClass, getTestName, isTestThread, localeForName, maybeChangeLiveIndexWriterConfig, maybeWrapReader, newAlcoholicMergePolicy, newAlcoholicMergePolicy, newDirectory, newDirectory, newDirectory, newDirectory, newDirectory, newField, newField, newFSDirectory, newFSDirectory, newIndexWriterConfig, newIndexWriterConfig, newIndexWriterConfig, newIOContext, newIOContext, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newMergePolicy, newMergePolicy, newMockDirectory, newMockDirectory, newMockDirectory, newMockFSDirectory, newMockFSDirectory, newSearcher, newSearcher, newSearcher, newStringField, newStringField, newStringField, newStringField, newTextField, newTextField, newTieredMergePolicy, newTieredMergePolicy, overrideDefaultQueryCache, overrideTestDefaultQueryCache, random, randomLocale, randomTimeZone, rarely, rarely, replaceMaxFailureRule, resetDefaultQueryCache, restoreCPUCoreCount, restoreIndexWriterMaxDocs, restoreSpins, runWithRestrictedPermissions, setIndexWriterMaxDocs, setupCPUCoreCount, setupSpins, slowFileExists, usually, usually, wrapReader

Methods inherited from class org.junit.Assert

assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertThat, assertThat, assertTrue, assertTrue, fail, fail

Methods inherited from class java.lang.Object

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

Constructor Detail

BasePostingsFormatTestCase

public BasePostingsFormatTestCase()

Method Detail

createPostings

public static void createPostings()
                           throws IOException

Throws:

IOException

afterClass

public static void afterClass()
                       throws Exception

Throws:

Exception

testDocsOnly

public void testDocsOnly()
                  throws Exception

Throws:

Exception

testDocsAndFreqs

public void testDocsAndFreqs()
                      throws Exception

Throws:

Exception

testDocsAndFreqsAndPositions

public void testDocsAndFreqsAndPositions()
                                  throws Exception

Throws:

Exception

testDocsAndFreqsAndPositionsAndPayloads

public void testDocsAndFreqsAndPositionsAndPayloads()
                                             throws Exception

Throws:

Exception

testDocsAndFreqsAndPositionsAndOffsets

public void testDocsAndFreqsAndPositionsAndOffsets()
                                            throws Exception

Throws:

Exception

testDocsAndFreqsAndPositionsAndOffsetsAndPayloads

public void testDocsAndFreqsAndPositionsAndOffsetsAndPayloads()
                                                       throws Exception

Throws:

Exception

testRandom

public void testRandom()
                throws Exception

Throws:

Exception

isPostingsEnumReuseImplemented

protected boolean isPostingsEnumReuseImplemented()

testPostingsEnumReuse

public void testPostingsEnumReuse()
                           throws Exception

Throws:

Exception

checkReuse

protected static void checkReuse(TermsEnum termsEnum,
              int firstFlags,
              int secondFlags,
              boolean shouldReuse)
                          throws IOException

Throws:

IOException

testJustEmptyField

public void testJustEmptyField()
                        throws Exception

Throws:

Exception

testEmptyFieldAndEmptyTerm

public void testEmptyFieldAndEmptyTerm()
                                throws Exception

Throws:

Exception

testDidntWantFreqsButAskedAnyway

public void testDidntWantFreqsButAskedAnyway()
                                      throws Exception

Throws:

Exception

testAskForPositionsWhenNotThere

public void testAskForPositionsWhenNotThere()
                                     throws Exception

Throws:

Exception

testGhosts

public void testGhosts()
                throws Exception

Throws:

Exception

testInvertedWrite

public void testInvertedWrite()
                       throws Exception

Throws:

Exception

assertReused

protected void assertReused(String field,
                PostingsEnum p1,
                PostingsEnum p2)

testPostingsEnumDocsOnly

public void testPostingsEnumDocsOnly()
                              throws Exception

Throws:

Exception

testPostingsEnumFreqs

public void testPostingsEnumFreqs()
                           throws Exception

Throws:

Exception

testPostingsEnumPositions

public void testPostingsEnumPositions()
                               throws Exception

Throws:

Exception

testPostingsEnumOffsets

public void testPostingsEnumOffsets()
                             throws Exception

Throws:

Exception

testPostingsEnumPayloads

public void testPostingsEnumPayloads()
                              throws Exception

Throws:

Exception

testPostingsEnumAll

public void testPostingsEnumAll()
                         throws Exception

Throws:

Exception

testLegacyEnumDocsOnly

@Deprecated
public void testLegacyEnumDocsOnly()
                            throws Exception

Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.

test legacy API (especially that we respect DocsAndPositionsEnum.OLD_NULL_SEMANTICS)

Throws:

Exception

testLegacyEnumFreqs

@Deprecated
public void testLegacyEnumFreqs()
                         throws Exception

Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.

test legacy API (especially that we respect DocsAndPositionsEnum.OLD_NULL_SEMANTICS)

Throws:

Exception

testLegacyEnumPositions

@Deprecated
public void testLegacyEnumPositions()
                             throws Exception

Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.

test legacy API

Throws:

Exception

testLegacyEnumOffsets

@Deprecated
public void testLegacyEnumOffsets()
                           throws Exception

Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.

test legacy API

Throws:

Exception

testLegacyEnumPayloads

@Deprecated
public void testLegacyEnumPayloads()
                            throws Exception

Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.

test legacy API

Throws:

Exception

testLegacyEnumAll

@Deprecated
public void testLegacyEnumAll()
                       throws Exception

Deprecated. only for testing DocsEnum/DocsAndPositionsEnum compat.

test legacy API

Throws:

Exception

addRandomFields

protected void addRandomFields(Document doc)

Add random fields to the provided document.

getCodec

protected abstract Codec getCodec()

Returns the codec to run tests against

setUp

public void setUp()
           throws Exception

Description copied from class: LuceneTestCase

For subclasses to override. Overrides must call super.setUp().

Overrides:

setUp in class LuceneTestCase

Throws:

Exception

tearDown

public void tearDown()
              throws Exception

Description copied from class: LuceneTestCase

For subclasses to override. Overrides must call super.tearDown().

Overrides:

tearDown in class LuceneTestCase

Throws:

Exception

excludedExtensionsFromByteCounts

protected Collection<String> excludedExtensionsFromByteCounts()

Return the list of extensions that should be excluded from byte counts when comparing indices that store the same content.

testMergeStability

public void testMergeStability()
                        throws Exception

The purpose of this test is to make sure that bulk merge doesn't accumulate useless data over runs.

Throws:

Exception

testRamBytesUsed

@LuceneTestCase.Slow
public void testRamBytesUsed()
                      throws IOException

Test the accuracy of the ramBytesUsed estimations.

Throws:

IOException

testMultiClose

public void testMultiClose()
                    throws IOException

Calls close multiple times on closeable codec apis

Throws:

IOException

testRandomExceptions

public void testRandomExceptions()
                          throws Exception

Tests exception handling on write and openInput/createOutput

Throws:

Exception