Package org.elasticsearch.index.engine

Class EngineTestCase

java.lang.Object

org.junit.Assert

org.apache.lucene.util.LuceneTestCase

org.elasticsearch.test.ESTestCase

org.elasticsearch.index.engine.EngineTestCase

public abstract class EngineTestCase
extends ESTestCase

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	EngineTestCase.IndexWriterFactory

Nested classes/interfaces inherited from class org.elasticsearch.test.ESTestCase

ESTestCase.GeohashGenerator, ESTestCase.TestAnalysis

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

org.apache.lucene.util.LuceneTestCase.AwaitsFix, org.apache.lucene.util.LuceneTestCase.BadApple, org.apache.lucene.util.LuceneTestCase.Monster, org.apache.lucene.util.LuceneTestCase.Nightly, org.apache.lucene.util.LuceneTestCase.Slow, org.apache.lucene.util.LuceneTestCase.SuppressCodecs, org.apache.lucene.util.LuceneTestCase.SuppressFileSystems, org.apache.lucene.util.LuceneTestCase.SuppressFsync, org.apache.lucene.util.LuceneTestCase.SuppressReproduceLine, org.apache.lucene.util.LuceneTestCase.SuppressSysoutChecks, org.apache.lucene.util.LuceneTestCase.SuppressTempFileChecks, org.apache.lucene.util.LuceneTestCase.ThrowingRunnable, org.apache.lucene.util.LuceneTestCase.Weekly

Field Summary

Fields

Modifier and Type	Field	Description
protected AllocationId	allocationId
protected static BytesReference	B_1
protected static BytesReference	B_2
protected static BytesReference	B_3
protected java.lang.String	codecName
protected IndexSettings	defaultSettings
protected InternalEngine	engine
protected static IndexSettings	INDEX_SETTINGS
protected java.util.concurrent.atomic.AtomicLong	primaryTerm
protected java.nio.file.Path	primaryTranslogDir
protected InternalEngine	replicaEngine
protected java.nio.file.Path	replicaTranslogDir
protected ShardId	shardId
protected static BytesArray	SOURCE
protected Store	store
protected Store	storeReplica
protected ThreadPool	threadPool

Fields inherited from class org.elasticsearch.test.ESTestCase

checkIndexFailed, deprecationLogger, failureAndSuccessEvents, logger

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_BADAPPLES, TEST_CODEC, TEST_DIRECTORY, TEST_DOCVALUESFORMAT, TEST_LINE_DOCS_FILE, TEST_MONSTER, TEST_NIGHTLY, TEST_POSTINGSFORMAT, TEST_SLOW, TEST_THROTTLING, TEST_WEEKLY, VERBOSE

Constructor Summary

Constructors

Constructor	Description
EngineTestCase()

Method Summary

Modifier and Type	Method	Description
protected static void	assertVisibleCount(Engine engine, int numDocs)
protected static void	assertVisibleCount(Engine engine, int numDocs, boolean refresh)
protected static BytesArray	bytesArray(java.lang.String string)
EngineConfig	config(IndexSettings indexSettings, Store store, java.nio.file.Path translogPath, MergePolicy mergePolicy, ReferenceManager.RefreshListener refreshListener)
EngineConfig	config(IndexSettings indexSettings, Store store, java.nio.file.Path translogPath, MergePolicy mergePolicy, ReferenceManager.RefreshListener refreshListener, Sort indexSort, java.util.function.LongSupplier globalCheckpointSupplier)
EngineConfig	copy(EngineConfig config, java.util.function.LongSupplier globalCheckpointSupplier)
EngineConfig	copy(EngineConfig config, org.apache.lucene.analysis.Analyzer analyzer)
protected InternalEngine	createEngine(EngineConfig config)
protected InternalEngine	createEngine(IndexSettings indexSettings, Store store, java.nio.file.Path translogPath, MergePolicy mergePolicy)
protected InternalEngine	createEngine(IndexSettings indexSettings, Store store, java.nio.file.Path translogPath, MergePolicy mergePolicy, EngineTestCase.IndexWriterFactory indexWriterFactory)
protected InternalEngine	createEngine(IndexSettings indexSettings, Store store, java.nio.file.Path translogPath, MergePolicy mergePolicy, EngineTestCase.IndexWriterFactory indexWriterFactory, java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier, java.util.function.LongSupplier globalCheckpointSupplier)
protected InternalEngine	createEngine(IndexSettings indexSettings, Store store, java.nio.file.Path translogPath, MergePolicy mergePolicy, EngineTestCase.IndexWriterFactory indexWriterFactory, java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier, java.util.function.LongSupplier globalCheckpointSupplier, java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation)
protected InternalEngine	createEngine(IndexSettings indexSettings, Store store, java.nio.file.Path translogPath, MergePolicy mergePolicy, EngineTestCase.IndexWriterFactory indexWriterFactory, java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier, java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation, Sort indexSort, java.util.function.LongSupplier globalCheckpointSupplier)
protected InternalEngine	createEngine(Store store, java.nio.file.Path translogPath)
protected InternalEngine	createEngine(Store store, java.nio.file.Path translogPath, java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier)
protected InternalEngine	createEngine(Store store, java.nio.file.Path translogPath, java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier, java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation)
protected InternalEngine	createEngine(Store store, java.nio.file.Path translogPath, java.util.function.LongSupplier globalCheckpointSupplier)
static InternalEngine	createInternalEngine(EngineTestCase.IndexWriterFactory indexWriterFactory, java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier, java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation, EngineConfig config)
static ParsedDocument	createParsedDoc(java.lang.String id, java.lang.String routing)
protected Store	createStore()
protected Store	createStore(org.apache.lucene.store.Directory directory)
protected Store	createStore(IndexSettings indexSettings, org.apache.lucene.store.Directory directory)
protected Translog	createTranslog(java.nio.file.Path translogPath, java.util.function.LongSupplier primaryTermSupplier)
protected Translog	createTranslog(java.util.function.LongSupplier primaryTermSupplier)
static long	generateNewSeqNo(Engine engine)	Generate a new sequence number and return it.
static Translog	getTranslog(Engine engine)	Exposes a translog associated with the given engine for testing purpose.
protected Engine.Index	indexForDoc(ParsedDocument doc)
protected Engine.Get	newGet(boolean realtime, ParsedDocument doc)
protected Term	newUid(java.lang.String id)
protected Term	newUid(ParsedDocument doc)
protected Engine.Delete	replicaDeleteForDoc(java.lang.String id, long version, long seqNo, long startTime)
protected Engine.Index	replicaIndexForDoc(ParsedDocument doc, long version, long seqNo, boolean isRetry)
void	setUp()
void	tearDown()
protected static ParseContext.Document	testDocument()
protected static ParseContext.Document	testDocumentWithTextField()
protected static ParseContext.Document	testDocumentWithTextField(java.lang.String value)
protected static ParsedDocument	testParsedDocument(java.lang.String id, java.lang.String routing, ParseContext.Document document, BytesReference source, Mapping mappingUpdate)

Methods inherited from class org.junit.Assert

assertArrayEquals, assertArrayEquals, 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, assertEquals, assertEquals, assertFalse, assertFalse, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertThat, assertThat, assertTrue, assertTrue, fail, fail

Methods inherited from class org.elasticsearch.test.ESTestCase

after, afterIfFailed, afterIfSuccessful, assertAllIndicesRemovedAndDeletionCompleted, assertArrayEquals, assertBusy, assertBusy, assertEquals, assertEqualsWithErrorMessageFromXContent, assertPathHasBeenCleared, assertSettingDeprecationsAndWarnings, assertSettingDeprecationsAndWarnings, assertWarnings, awaitBusy, awaitBusy, before, between, buildNewFakeTransportAddress, checkStaticState, copyStreamable, copyWriteable, copyWriteable, createParser, createParser, createParser, createParser, createParser, createTestAnalysis, createTestAnalysis, createTestAnalysis, enableWarningsCheck, ensureAllSearchContextsReleased, ensureCheckIndexPassed, frequently, generateRandomStringArray, generateRandomStringArray, getBwcIndicesPath, getDataPath, getSuiteFailureMarker, getTestTransportPlugin, getTestTransportType, inFipsJvm, iterations, maybeSet, mockScript, newNodeEnvironment, newNodeEnvironment, newTestIndicesModule, newTestScriptModule, randomAlphaOfLength, randomAlphaOfLengthBetween, randomArray, randomArray, randomBoolean, randomByte, randomByteArrayOfLength, randomDateTimeZone, randomDouble, randomDoubleBetween, randomFloat, randomFrom, randomFrom, randomFrom, randomFrom, randomFrom, randomGeohash, randomInt, randomInt, randomIntBetween, randomLong, randomLongBetween, randomNonNegativeLong, randomPositiveTimeValue, randomRealisticUnicodeOfCodepointLength, randomRealisticUnicodeOfCodepointLengthBetween, randomRealisticUnicodeOfLength, randomRealisticUnicodeOfLengthBetween, randomShort, randomSubsetOf, randomSubsetOf, randomSubsetOf, randomTimeValue, randomTimeValue, randomTimeValue, randomTimeZone, randomUnicodeOfCodepointLength, randomUnicodeOfCodepointLengthBetween, randomUnicodeOfLength, randomUnicodeOfLengthBetween, randomUnique, randomValueOtherThan, randomValueOtherThanMany, randomZone, resetCheckIndexStatus, resetPortCounter, restoreContentType, restoreFileSystem, scaledRandomIntBetween, setContentType, setFileSystem, settings, setUseNio, shuffleMap, shuffleXContent, shuffleXContent, spinForAtLeastNMilliseconds, spinForAtLeastOneMillisecond, terminate, terminate, tmpPaths, toShuffledXContent, toShuffledXContent, writableRegistry, xContentRegistry

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

addVirusChecker, assertDeletedDocsEquals, assertDocsAndPositionsEnumEquals, assertDocsEnumEquals, assertDocsSkippingEquals, assertDocValuesEquals, assertDocValuesEquals, assertFieldInfosEquals, assertFieldsEquals, assertFieldStatisticsEquals, assertNormsEquals, assertPointsEquals, assertPositionsSkippingEquals, assertReaderEquals, assertReaderStatisticsEquals, assertStoredFieldEquals, assertStoredFieldsEquals, assertTermsEnumEquals, assertTermsEquals, assertTermsStatisticsEquals, assertTermStatsEquals, assertTermVectorsEquals, asSet, assumeFalse, assumeNoException, assumeTrue, assumeWorkingMMapOnWindows, atLeast, atLeast, closeAfterSuite, closeAfterTest, collate, createTempDir, createTempDir, createTempFile, createTempFile, dumpArray, dumpIterator, expectThrows, expectThrows, getBaseTempDirForTestClass, getDataInputStream, getOnlyLeafReader, getTestClass, getTestName, hasWorkingMMapOnWindows, isTestThread, localeForLanguageTag, maybeChangeLiveIndexWriterConfig, maybeWrapReader, newAlcoholicMergePolicy, newAlcoholicMergePolicy, newDirectory, newDirectory, newDirectory, newDirectory, newDirectory, newField, newField, newFSDirectory, newFSDirectory, newIndexWriterConfig, newIndexWriterConfig, newIndexWriterConfig, newIOContext, newIOContext, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newLogMergePolicy, newMaybeVirusCheckingDirectory, newMaybeVirusCheckingFSDirectory, newMergePolicy, 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 java.lang.Object

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

Field Detail

shardId

protected final ShardId shardId

allocationId

protected final AllocationId allocationId

INDEX_SETTINGS

protected static final IndexSettings INDEX_SETTINGS

threadPool

protected ThreadPool threadPool

store

protected Store store

storeReplica

protected Store storeReplica

engine

protected InternalEngine engine

replicaEngine

protected InternalEngine replicaEngine

defaultSettings

protected IndexSettings defaultSettings

codecName

protected java.lang.String codecName

primaryTranslogDir

protected java.nio.file.Path primaryTranslogDir

replicaTranslogDir

protected java.nio.file.Path replicaTranslogDir

primaryTerm

protected java.util.concurrent.atomic.AtomicLong primaryTerm

B_1

protected static final BytesReference B_1

B_2

protected static final BytesReference B_2

B_3

protected static final BytesReference B_3

SOURCE

protected static final BytesArray SOURCE

Constructor Detail

EngineTestCase

public EngineTestCase()

Method Detail

assertVisibleCount

protected static void assertVisibleCount(Engine engine,
                                         int numDocs)
                                  throws java.io.IOException

Throws:

java.io.IOException

assertVisibleCount

protected static void assertVisibleCount(Engine engine,
                                         int numDocs,
                                         boolean refresh)
                                  throws java.io.IOException

Throws:

java.io.IOException

setUp

public void setUp()
           throws java.lang.Exception

Overrides:

setUp in class org.apache.lucene.util.LuceneTestCase

Throws:

java.lang.Exception

copy

public EngineConfig copy(EngineConfig config,
                         java.util.function.LongSupplier globalCheckpointSupplier)

copy

public EngineConfig copy(EngineConfig config,
                         org.apache.lucene.analysis.Analyzer analyzer)

tearDown

public void tearDown()
              throws java.lang.Exception

Overrides:

tearDown in class org.apache.lucene.util.LuceneTestCase

Throws:

java.lang.Exception

testDocumentWithTextField

protected static ParseContext.Document testDocumentWithTextField()

testDocumentWithTextField

protected static ParseContext.Document testDocumentWithTextField(java.lang.String value)

testDocument

protected static ParseContext.Document testDocument()

createParsedDoc

public static ParsedDocument createParsedDoc(java.lang.String id,
                                             java.lang.String routing)

testParsedDocument

protected static ParsedDocument testParsedDocument(java.lang.String id,
                                                   java.lang.String routing,
                                                   ParseContext.Document document,
                                                   BytesReference source,
                                                   Mapping mappingUpdate)

createStore

protected Store createStore()
                     throws java.io.IOException

Throws:

java.io.IOException

createStore

protected Store createStore(org.apache.lucene.store.Directory directory)
                     throws java.io.IOException

Throws:

java.io.IOException

createStore

protected Store createStore(IndexSettings indexSettings,
                            org.apache.lucene.store.Directory directory)
                     throws java.io.IOException

Throws:

java.io.IOException

createTranslog

protected Translog createTranslog(java.util.function.LongSupplier primaryTermSupplier)
                           throws java.io.IOException

Throws:

java.io.IOException

createTranslog

protected Translog createTranslog(java.nio.file.Path translogPath,
                                  java.util.function.LongSupplier primaryTermSupplier)
                           throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(Store store,
                                      java.nio.file.Path translogPath)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(Store store,
                                      java.nio.file.Path translogPath,
                                      java.util.function.LongSupplier globalCheckpointSupplier)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(Store store,
                                      java.nio.file.Path translogPath,
                                      java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(Store store,
                                      java.nio.file.Path translogPath,
                                      java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier,
                                      java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(IndexSettings indexSettings,
                                      Store store,
                                      java.nio.file.Path translogPath,
                                      MergePolicy mergePolicy)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(IndexSettings indexSettings,
                                      Store store,
                                      java.nio.file.Path translogPath,
                                      MergePolicy mergePolicy,
                                      @Nullable
                                      EngineTestCase.IndexWriterFactory indexWriterFactory)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(IndexSettings indexSettings,
                                      Store store,
                                      java.nio.file.Path translogPath,
                                      MergePolicy mergePolicy,
                                      @Nullable
                                      EngineTestCase.IndexWriterFactory indexWriterFactory,
                                      @Nullable
                                      java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier,
                                      @Nullable
                                      java.util.function.LongSupplier globalCheckpointSupplier)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(IndexSettings indexSettings,
                                      Store store,
                                      java.nio.file.Path translogPath,
                                      MergePolicy mergePolicy,
                                      @Nullable
                                      EngineTestCase.IndexWriterFactory indexWriterFactory,
                                      @Nullable
                                      java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier,
                                      @Nullable
                                      java.util.function.LongSupplier globalCheckpointSupplier,
                                      @Nullable
                                      java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(IndexSettings indexSettings,
                                      Store store,
                                      java.nio.file.Path translogPath,
                                      MergePolicy mergePolicy,
                                      @Nullable
                                      EngineTestCase.IndexWriterFactory indexWriterFactory,
                                      @Nullable
                                      java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier,
                                      @Nullable
                                      java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation,
                                      @Nullable
                                      Sort indexSort,
                                      @Nullable
                                      java.util.function.LongSupplier globalCheckpointSupplier)
                               throws java.io.IOException

Throws:

java.io.IOException

createEngine

protected InternalEngine createEngine(EngineConfig config)
                               throws java.io.IOException

Throws:

java.io.IOException

generateNewSeqNo

public static long generateNewSeqNo(Engine engine)

Generate a new sequence number and return it. Only works on InternalEngines

createInternalEngine

public static InternalEngine createInternalEngine(@Nullable
                                                  EngineTestCase.IndexWriterFactory indexWriterFactory,
                                                  @Nullable
                                                  java.util.function.BiFunction<java.lang.Long,java.lang.Long,LocalCheckpointTracker> localCheckpointTrackerSupplier,
                                                  @Nullable
                                                  java.util.function.ToLongBiFunction<Engine,Engine.Operation> seqNoForOperation,
                                                  EngineConfig config)

config

public EngineConfig config(IndexSettings indexSettings,
                           Store store,
                           java.nio.file.Path translogPath,
                           MergePolicy mergePolicy,
                           ReferenceManager.RefreshListener refreshListener)

config

public EngineConfig config(IndexSettings indexSettings,
                           Store store,
                           java.nio.file.Path translogPath,
                           MergePolicy mergePolicy,
                           ReferenceManager.RefreshListener refreshListener,
                           Sort indexSort,
                           java.util.function.LongSupplier globalCheckpointSupplier)

bytesArray

protected static BytesArray bytesArray(java.lang.String string)

newUid

protected Term newUid(java.lang.String id)

newUid

protected Term newUid(ParsedDocument doc)

newGet

protected Engine.Get newGet(boolean realtime,
                            ParsedDocument doc)

indexForDoc

protected Engine.Index indexForDoc(ParsedDocument doc)

replicaIndexForDoc

protected Engine.Index replicaIndexForDoc(ParsedDocument doc,
                                          long version,
                                          long seqNo,
                                          boolean isRetry)

replicaDeleteForDoc

protected Engine.Delete replicaDeleteForDoc(java.lang.String id,
                                            long version,
                                            long seqNo,
                                            long startTime)

getTranslog

public static Translog getTranslog(Engine engine)

Exposes a translog associated with the given engine for testing purpose.