org.apache.lucene.search

Class BaseExplanationTestCase

java.lang.Object

org.junit.Assert

org.apache.lucene.util.LuceneTestCase

org.apache.lucene.search.BaseExplanationTestCase

@LuceneTestCase.SuppressCodecs(value="Lucene3x")
public abstract class BaseExplanationTestCase
extends LuceneTestCase

Tests primitive queries (ie: that rewrite to themselves) to insure they match the expected set of docs, and that the score of each match is equal to the value of the scores explanation.

The assumption is that if all of the "primitive" queries work well, then anything that rewrites to a primitive will work well also.

See Also:

"Subclasses for actual tests"

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BaseExplanationTestCase.ItemizedFilter Convenience subclass of FieldCacheTermsFilter

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

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

Field Summary

Fields

Modifier and Type	Field and Description
static String	ALTFIELD
protected static Directory	directory
protected static String[]	docFields
static String	FIELD
static String	KEY
protected static IndexReader	reader
protected static IndexSearcher	searcher

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

assertsAreEnabled, classRules, DEFAULT_LINE_DOCS_FILE, doesntSupportOffsets, INFOSTREAM, JENKINS_LARGE_LINE_DOCS_FILE, LEAVE_TEMPORARY, OLD_FORMAT_IMPERSONATION_IS_ACTIVE, RANDOM_MULTIPLIER, ruleChain, 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_VERSION_CURRENT, TEST_WEEKLY, VERBOSE

Constructor Summary

Constructors

Constructor and Description
BaseExplanationTestCase()

Method Summary

Methods

Modifier and Type	Method and Description
static void	afterClassTestExplanations()
static void	beforeClassTestExplanations()
void	bqtest(Query q, int[] expDocNrs) Tests a query using qtest after wrapping it with both optB and reqB
Query	optB(Query q) MACRO: Wraps a Query in a BooleanQuery so that it is optional, along with a second prohibited clause which will never match anything
void	qtest(Query q, int[] expDocNrs) check the expDocNrs first, then check the query (and the explanations)
Query	reqB(Query q) MACRO: Wraps a Query in a BooleanQuery so that it is required, along with a second optional clause which will match everything
SpanFirstQuery	sf(String s, int b) MACRO for SpanFirst(SpanTermQuery)
SpanNearQuery	snear(SpanQuery s, SpanQuery e, int slop, boolean inOrder) MACRO for SpanNearQuery containing two SpanQueries
SpanNearQuery	snear(SpanQuery s, SpanQuery m, SpanQuery e, int slop, boolean inOrder) MACRO for SpanNearQuery containing three SpanQueries
SpanNearQuery	snear(String s, String e, int slop, boolean inOrder) MACRO for SpanNearQuery containing two SpanTerm queries
SpanNearQuery	snear(String s, String m, String e, int slop, boolean inOrder) MACRO for SpanNearQuery containing three SpanTerm queries
SpanNotQuery	snot(SpanQuery i, SpanQuery e) MACRO for SpanNotQuery
SpanOrQuery	sor(SpanQuery s, SpanQuery e) MACRO for SpanOrQuery containing two SpanQueries
SpanOrQuery	sor(SpanQuery s, SpanQuery m, SpanQuery e) MACRO for SpanOrQuery containing two SpanQueries
SpanOrQuery	sor(String s, String e) MACRO for SpanOrQuery containing two SpanTerm queries
SpanOrQuery	sor(String s, String m, String e) MACRO for SpanOrQuery containing three SpanTerm queries
SpanTermQuery	st(String s) MACRO for SpanTermQuery
static Term[]	ta(String[] s) helper for generating MultiPhraseQueries

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

assertDeletedDocsEquals, assertDocsAndPositionsEnumEquals, assertDocsEnumEquals, assertDocsSkippingEquals, assertDocValuesEquals, assertDocValuesEquals, assertFieldInfosEquals, assertFieldsEquals, assertFieldStatisticsEquals, assertNormsEquals, assertPositionsSkippingEquals, assertReaderEquals, assertReaderStatisticsEquals, assertSaneFieldCaches, assertStoredFieldEquals, assertStoredFieldsEquals, assertTermsEnumEquals, assertTermsEquals, assertTermsStatisticsEquals, assertTermStatsEquals, assertTermVectorsEquals, asSet, assumeFalse, assumeNoException, assumeTrue, atLeast, atLeast, closeAfterSuite, closeAfterTest, createTempDir, createTempDir, createTempFile, createTempFile, defaultCodecSupportsDocsWithField, defaultCodecSupportsDocValues, defaultCodecSupportsFieldUpdates, defaultCodecSupportsMissingDocValues, defaultCodecSupportsSortedNumeric, defaultCodecSupportsSortedSet, dumpArray, dumpIterator, getBaseTempDirForTestClass, getDataFile, getOnlySegmentReader, getTestClass, getTestName, isTestThread, localeForName, maybeChangeLiveIndexWriterConfig, maybeWrapReader, newAlcoholicMergePolicy, newAlcoholicMergePolicy, newDirectory, newDirectory, newDirectory, newDirectory, newField, newField, newFSDirectory, newFSDirectory, newIndexWriterConfig, newIndexWriterConfig, newIOContext, newIOContext, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newMergePolicy, newMergePolicy, newMockDirectory, newMockDirectory, newMockFSDirectory, newSearcher, newSearcher, newSearcher, newStringField, newStringField, newTextField, newTextField, newTieredMergePolicy, newTieredMergePolicy, random, randomLocale, randomTimeZone, rarely, rarely, replaceMaxFailureRule, restoreIndexWriterMaxDocs, setIndexWriterMaxDocs, setUp, slowFileExists, tearDown, usually, usually

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

Field Detail

searcher

protected static IndexSearcher searcher

reader

protected static IndexReader reader

directory

protected static Directory directory

KEY

public static final String KEY

See Also:

Constant Field Values

FIELD

public static final String FIELD

See Also:

Constant Field Values

ALTFIELD

public static final String ALTFIELD

See Also:

Constant Field Values

docFields

protected static final String[] docFields

Constructor Detail

BaseExplanationTestCase

public BaseExplanationTestCase()

Method Detail

afterClassTestExplanations

public static void afterClassTestExplanations()
                                       throws Exception

Throws:

Exception

beforeClassTestExplanations

public static void beforeClassTestExplanations()
                                        throws Exception

Throws:

Exception

qtest

public void qtest(Query q,
         int[] expDocNrs)
           throws Exception

check the expDocNrs first, then check the query (and the explanations)

Throws:

Exception

bqtest

public void bqtest(Query q,
          int[] expDocNrs)
            throws Exception

Tests a query using qtest after wrapping it with both optB and reqB

Throws:

Exception

See Also:

qtest(org.apache.lucene.search.Query, int[]), reqB(org.apache.lucene.search.Query), optB(org.apache.lucene.search.Query)

ta

public static Term[] ta(String[] s)

helper for generating MultiPhraseQueries

st

public SpanTermQuery st(String s)

MACRO for SpanTermQuery

snot

public SpanNotQuery snot(SpanQuery i,
                SpanQuery e)

MACRO for SpanNotQuery

sor

public SpanOrQuery sor(String s,
              String e)

MACRO for SpanOrQuery containing two SpanTerm queries

sor

public SpanOrQuery sor(SpanQuery s,
              SpanQuery e)

MACRO for SpanOrQuery containing two SpanQueries

sor

public SpanOrQuery sor(String s,
              String m,
              String e)

MACRO for SpanOrQuery containing three SpanTerm queries

sor

public SpanOrQuery sor(SpanQuery s,
              SpanQuery m,
              SpanQuery e)

MACRO for SpanOrQuery containing two SpanQueries

snear

public SpanNearQuery snear(String s,
                  String e,
                  int slop,
                  boolean inOrder)

MACRO for SpanNearQuery containing two SpanTerm queries

snear

public SpanNearQuery snear(SpanQuery s,
                  SpanQuery e,
                  int slop,
                  boolean inOrder)

MACRO for SpanNearQuery containing two SpanQueries

snear

public SpanNearQuery snear(String s,
                  String m,
                  String e,
                  int slop,
                  boolean inOrder)

MACRO for SpanNearQuery containing three SpanTerm queries

snear

public SpanNearQuery snear(SpanQuery s,
                  SpanQuery m,
                  SpanQuery e,
                  int slop,
                  boolean inOrder)

MACRO for SpanNearQuery containing three SpanQueries

sf

public SpanFirstQuery sf(String s,
                int b)

MACRO for SpanFirst(SpanTermQuery)

optB

public Query optB(Query q)
           throws Exception

MACRO: Wraps a Query in a BooleanQuery so that it is optional, along with a second prohibited clause which will never match anything

Throws:

Exception

reqB

public Query reqB(Query q)
           throws Exception

MACRO: Wraps a Query in a BooleanQuery so that it is required, along with a second optional clause which will match everything

Throws:

Exception