Package org.elasticsearch.test

Class AbstractXContentTestCase<T extends org.elasticsearch.xcontent.ToXContent>

java.lang.Object

org.junit.Assert

org.apache.lucene.util.LuceneTestCase

org.elasticsearch.test.ESTestCase

org.elasticsearch.test.AbstractXContentTestCase<T>

Direct Known Subclasses:

AbstractBroadcastResponseTestCase

public abstract class AbstractXContentTestCase<T extends org.elasticsearch.xcontent.ToXContent>
extends ESTestCase

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractXContentTestCase.XContentTester<T>	Tests converting to and from xcontent.

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

ESTestCase.DeprecationWarning, 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 static final int	NUMBER_OF_TEST_RUNS

Fields inherited from class org.elasticsearch.test.ESTestCase

checkIndexFailures, DEFAULT_TEST_WORKER_ID, failureAndSuccessEvents, FIPS_SYSPROP, JAVA_TIMEZONE_IDS, JAVA_ZONE_IDS, logger, MIN_PRIVATE_PORT, TEST_WORKER_SYS_PROPERTY, TEST_WORKER_VM_ID

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
AbstractXContentTestCase()

Method Summary

Modifier and Type	Method	Description
protected void	assertEqualInstances(T expectedInstance, T newInstance)
protected boolean	assertToXContentEquivalence()
protected abstract T	createTestInstance()	Creates a random test instance to use in the tests.
protected abstract T	doParseInstance(org.elasticsearch.xcontent.XContentParser parser)	Parses to a new instance using the provided XContentParser
protected Predicate<String>	getRandomFieldsExcludeFilter()	Returns a predicate that given the field name indicates whether the field has to be excluded from random fields insertion or not
protected String[]	getShuffleFieldsExceptions()	Fields that have to be ignored when shuffling as part of testFromXContent
protected org.elasticsearch.xcontent.ToXContent.Params	getToXContentParams()	Params that have to be provided when calling ToXContent.toXContent(XContentBuilder, ToXContent.Params)
protected abstract boolean	supportsUnknownFields()	Indicates whether the parser supports unknown fields or not.
final void	testFromXContent()	Generic test that creates new instance from the test instance and checks both for equality and asserts equality on the two queries.
static <T extends org.elasticsearch.xcontent.ToXContent> void	testFromXContent(int numberOfTestRuns, Supplier<T> instanceSupplier, boolean supportsUnknownFields, String[] shuffleFieldsExceptions, Predicate<String> randomFieldsExcludeFilter, org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParserFunction, org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent, BiConsumer<T,T> assertEqualsConsumer, boolean assertToXContentEquivalence, org.elasticsearch.xcontent.ToXContent.Params toXContentParams)
static <T extends org.elasticsearch.xcontent.ToXContent> AbstractXContentTestCase.XContentTester<T>	xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser, Function<org.elasticsearch.xcontent.XContentType,T> instanceSupplier, org.elasticsearch.xcontent.ToXContent.Params toXContentParams, org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)
static <T> AbstractXContentTestCase.XContentTester<T>	xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser, Supplier<T> instanceSupplier, org.elasticsearch.common.CheckedBiConsumer<T,org.elasticsearch.xcontent.XContentBuilder,IOException> toXContent, org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)
static <T extends org.elasticsearch.xcontent.ToXContent> AbstractXContentTestCase.XContentTester<T>	xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser, Supplier<T> instanceSupplier, org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)
static <T extends org.elasticsearch.xcontent.ToXContent> AbstractXContentTestCase.XContentTester<T>	xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser, Supplier<T> instanceSupplier, org.elasticsearch.xcontent.ToXContent.Params toXContentParams, org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)

Methods inherited from class org.elasticsearch.test.ESTestCase

after, afterIfFailed, afterIfSuccessful, assertArrayEquals, assertBusy, assertBusy, assertCriticalWarnings, assertEquals, assertSettingDeprecationsAndWarnings, assertWarnings, assertWarnings, before, between, buildEnvSettings, buildNewFakeTransportAddress, checkStaticState, compatibleMediaType, copyInstance, copyNamedWriteable, copyNamedWriteable, copyWriteable, copyWriteable, createDefaultIndexAnalyzers, createParser, createParser, createParser, createParser, createParser, createParser, createParserWithCompatibilityFor, createTestAnalysis, createTestAnalysis, createTestAnalysis, enableWarningsCheck, ensureAllSearchContextsReleased, ensureCheckIndexPassed, ensureNoWarnings, ensureSupportedLocale, filteredWarnings, frequently, generateRandomStringArray, generateRandomStringArray, getBasePort, getDataPath, getPortRange, getSuiteFailureMarker, getTestTransportPlugin, getTestTransportType, inFipsJvm, iterations, maybeSet, mockScript, newEnvironment, newEnvironment, newNodeEnvironment, newNodeEnvironment, parserConfig, randomAlphaOfLength, randomAlphaOfLengthBetween, randomArray, randomArray, randomBigInteger, randomBoolean, randomByte, randomByteArrayOfLength, randomCompatibleMediaType, randomDateFormatterPattern, randomDouble, randomDoubleBetween, randomFloat, randomFrom, randomFrom, randomFrom, randomFrom, randomFrom, randomFrom, randomGeohash, randomInt, randomInt, randomIntBetween, randomIp, randomList, randomList, randomLong, randomLongBetween, randomMap, randomMillisUpToYear9999, randomNonNegativeByte, randomNonNegativeLong, randomPositiveTimeValue, randomRealisticUnicodeOfCodepointLength, randomRealisticUnicodeOfCodepointLengthBetween, randomRealisticUnicodeOfLength, randomRealisticUnicodeOfLengthBetween, randomShort, randomSubsetOf, randomSubsetOf, randomSubsetOf, randomTimeValue, randomTimeValue, randomTimeValue, randomTimeZone, randomUnicodeOfCodepointLength, randomUnicodeOfCodepointLengthBetween, randomUnicodeOfLength, randomUnicodeOfLengthBetween, randomUnique, randomValueOtherThan, randomValueOtherThanMany, randomVendorType, randomZone, removeHeaderWarningAppender, resetCheckIndexStatus, resetPortCounter, restoreContentType, restoreFileSystem, scaledRandomIntBetween, setContentType, setFileSystem, setHeaderWarningAppender, settings, shuffleMap, shuffleXContent, shuffleXContent, skipTestWaitingForLuceneFix, spinForAtLeastNMilliseconds, spinForAtLeastOneMillisecond, terminate, terminate, tmpPaths, toShuffledXContent, waitUntil, waitUntil, writableRegistry, xContentRegistry

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

addVirusChecker, assertDeletedDocsEquals, assertDocsAndPositionsEnumEquals, assertDocsEnumEquals, assertDocsSkippingEquals, assertDocValuesEquals, assertDocValuesEquals, assertFieldInfosEquals, assertNormsEquals, assertPointsEquals, assertPositionsSkippingEquals, assertReaderEquals, assertReaderStatisticsEquals, assertStoredFieldEquals, assertStoredFieldsEquals, assertTermsEnumEquals, assertTermsEquals, assertTermsEquals, assertTermsStatisticsEquals, assertTermStatsEquals, assertTermVectorsEquals, asSet, assumeFalse, assumeNoException, assumeTrue, assumeWorkingMMapOnWindows, atLeast, atLeast, callStackContains, callStackContains, callStackContainsAnyOf, closeAfterSuite, closeAfterTest, collate, createTempDir, createTempDir, createTempFile, createTempFile, dumpArray, dumpIterator, ensureSaneIWCOnNightly, expectThrows, expectThrows, expectThrows, expectThrowsAnyOf, expectThrowsAnyOf, getDataInputStream, getOnlyLeafReader, getTestClass, getTestName, hasWorkingMMapOnWindows, isTestThread, localeForLanguageTag, maybeChangeLiveIndexWriterConfig, maybeWrapReader, newAlcoholicMergePolicy, newAlcoholicMergePolicy, newBytesRef, newBytesRef, newBytesRef, newBytesRef, newBytesRef, newBytesRef, 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, newSearcher, newStringField, newStringField, newStringField, newStringField, newTextField, newTextField, newTieredMergePolicy, newTieredMergePolicy, overrideDefaultQueryCache, overrideTestDefaultQueryCache, random, randomLocale, randomTimeZone, rarely, rarely, replaceMaxFailureRule, resetDefaultQueryCache, restoreCPUCoreCount, restoreIndexWriterMaxDocs, runWithRestrictedPermissions, setIndexWriterMaxDocs, setUp, setupCPUCoreCount, slowFileExists, tearDown, 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, 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 java.lang.Object

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

Field Details

NUMBER_OF_TEST_RUNS

protected static final int NUMBER_OF_TEST_RUNS

See Also:

• Constant Field Values

Constructor Details

AbstractXContentTestCase

public AbstractXContentTestCase()

Method Details

xContentTester

public static <T>
AbstractXContentTestCase.XContentTester<T> xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser,
 Supplier<T> instanceSupplier,
 org.elasticsearch.common.CheckedBiConsumer<T,org.elasticsearch.xcontent.XContentBuilder,IOException> toXContent,
 org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)

xContentTester

public static <T extends org.elasticsearch.xcontent.ToXContent>
AbstractXContentTestCase.XContentTester<T> xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser,
 Supplier<T> instanceSupplier,
 org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)

xContentTester

public static <T extends org.elasticsearch.xcontent.ToXContent>
AbstractXContentTestCase.XContentTester<T> xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser,
 Supplier<T> instanceSupplier,
 org.elasticsearch.xcontent.ToXContent.Params toXContentParams,
 org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)

xContentTester

public static <T extends org.elasticsearch.xcontent.ToXContent>
AbstractXContentTestCase.XContentTester<T> xContentTester(org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParser,
 Function<org.elasticsearch.xcontent.XContentType,T> instanceSupplier,
 org.elasticsearch.xcontent.ToXContent.Params toXContentParams,
 org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent)

testFromXContent

public static <T extends org.elasticsearch.xcontent.ToXContent>
void testFromXContent(int numberOfTestRuns,
 Supplier<T> instanceSupplier,
 boolean supportsUnknownFields,
 String[] shuffleFieldsExceptions,
 Predicate<String> randomFieldsExcludeFilter,
 org.elasticsearch.common.CheckedBiFunction<org.elasticsearch.xcontent.XContent,org.elasticsearch.common.bytes.BytesReference,org.elasticsearch.xcontent.XContentParser,IOException> createParserFunction,
 org.elasticsearch.core.CheckedFunction<org.elasticsearch.xcontent.XContentParser,T,IOException> fromXContent,
 BiConsumer<T,T> assertEqualsConsumer,
 boolean assertToXContentEquivalence,
 org.elasticsearch.xcontent.ToXContent.Params toXContentParams)
               throws IOException

Throws:

IOException

testFromXContent

public final void testFromXContent()
                            throws IOException

Generic test that creates new instance from the test instance and checks both for equality and asserts equality on the two queries.

Throws:

IOException

createTestInstance

protected abstract T createTestInstance()

Creates a random test instance to use in the tests. This method will be called multiple times during test execution and should return a different random instance each time it is called.

doParseInstance

protected abstract T doParseInstance(org.elasticsearch.xcontent.XContentParser parser)
                              throws IOException

Parses to a new instance using the provided XContentParser

Throws:

IOException

assertEqualInstances

protected void assertEqualInstances(T expectedInstance,
 T newInstance)

assertToXContentEquivalence

protected boolean assertToXContentEquivalence()

supportsUnknownFields

protected abstract boolean supportsUnknownFields()

Indicates whether the parser supports unknown fields or not. In case it does, such behaviour will be tested by inserting random fields before parsing and checking that they don't make parsing fail.

getRandomFieldsExcludeFilter

protected Predicate<String> getRandomFieldsExcludeFilter()

Returns a predicate that given the field name indicates whether the field has to be excluded from random fields insertion or not

getShuffleFieldsExceptions

protected String[] getShuffleFieldsExceptions()

Fields that have to be ignored when shuffling as part of testFromXContent

getToXContentParams

protected org.elasticsearch.xcontent.ToXContent.Params getToXContentParams()

Params that have to be provided when calling ToXContent.toXContent(XContentBuilder, ToXContent.Params)