org.elasticsearch.test.rest

Class ESRestTestCase

java.lang.Object

org.junit.Assert

org.apache.lucene.util.LuceneTestCase

org.elasticsearch.test.ESTestCase

org.elasticsearch.test.rest.ESRestTestCase

Direct Known Subclasses:

ESClientYamlSuiteTestCase

public abstract class ESRestTestCase
extends ESTestCase

Superclass for tests that interact with an external test cluster using Elasticsearch's RestClient.

Nested Class Summary

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 and Description
static java.lang.String	CLIENT_RETRY_TIMEOUT
static java.lang.String	CLIENT_SOCKET_TIMEOUT
static java.lang.String	TRUSTSTORE_PASSWORD
static java.lang.String	TRUSTSTORE_PATH

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_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
ESRestTestCase()

Method Summary

Modifier and Type	Method and Description
protected static RestClient	adminClient() Get the client used for test administrative actions.
protected void	assertOK(Response response)
protected RestClient	buildClient(Settings settings, org.apache.http.HttpHost[] hosts)
void	cleanUpCluster() Clean up after the test case.
protected static RestClient	client() Get the client used for ordinary api calls while writing a test
static void	closeClients()
protected void	createIndex(java.lang.String name, Settings settings)
protected void	createIndex(java.lang.String name, Settings settings, java.lang.String mapping)
protected void	ensureGreen()
java.util.Map<java.lang.String,java.lang.Object>	entityAsMap(Response response) Convert the entity from a Response into a map of maps.
protected java.util.List<org.apache.http.HttpHost>	getClusterHosts() Get the list of hosts in the cluster.
protected java.lang.String	getProtocol() Override this to switch to testing https.
void	initClient()
protected boolean	preserveIndicesUponCompletion() Returns whether to preserve the indices created during this test on completion of this test.
protected boolean	preserveReposUponCompletion() Returns whether to preserve the repositories on completion of this test.
protected boolean	preserveSnapshotsUponCompletion() Returns whether to preserve the snapshots in repositories on completion of this test.
protected boolean	preserveTemplatesUponCompletion() Controls whether or not to preserve templates upon completion of this test.
protected Settings	restAdminSettings() Returns the REST client settings used for admin actions like cleaning up after the test has completed.
protected Settings	restClientSettings() Used to obtain settings for the REST client that is used to send REST requests.

Methods inherited from class org.elasticsearch.test.ESTestCase

after, afterIfFailed, afterIfSuccessful, assertAllIndicesRemovedAndDeletionCompleted, assertArrayEquals, assertBusy, assertBusy, assertEquals, assertEqualsWithErrorMessageFromXContent, assertPathHasBeenCleared, assertSettingDeprecationsAndWarnings, assertWarnings, awaitBusy, awaitBusy, before, between, buildNewFakeTransportAddress, checkStaticState, copyWriteable, createParser, createParser, createParser, createParser, createParser, createTestAnalysis, createTestAnalysis, createTestAnalysis, enableWarningsCheck, ensureAllSearchContextsReleased, ensureCheckIndexPassed, frequently, generateRandomStringArray, generateRandomStringArray, getBwcIndicesPath, getDataPath, getSuiteFailureMarker, iterations, maybeSet, mockScript, newNodeEnvironment, newNodeEnvironment, newTestIndicesModule, newTestScriptModule, randomAlphaOfLength, randomAlphaOfLengthBetween, randomBoolean, randomByte, randomDateTimeZone, randomDouble, randomDoubleBetween, randomFloat, randomFrom, randomFrom, randomFrom, randomFrom, randomFrom, randomGeohash, randomInt, randomInt, randomIntBetween, randomLong, randomNonNegativeLong, randomPositiveTimeValue, randomRealisticUnicodeOfCodepointLength, randomRealisticUnicodeOfCodepointLengthBetween, randomRealisticUnicodeOfLength, randomRealisticUnicodeOfLengthBetween, randomShort, randomSubsetOf, randomSubsetOf, randomSubsetOf, randomTimeValue, randomTimeValue, randomTimeValue, randomUnicodeOfCodepointLength, randomUnicodeOfCodepointLengthBetween, randomUnicodeOfLength, randomUnicodeOfLengthBetween, randomUnique, randomValueOtherThan, randomValueOtherThanMany, resetCheckIndexStatus, resetPortCounter, restoreContentType, restoreFileSystem, scaledRandomIntBetween, setContentType, setFileSystem, settings, shuffleMap, shuffleXContent, shuffleXContent, spinForAtLeastNMilliseconds, spinForAtLeastOneMillisecond, terminate, terminate, tmpPaths, 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, 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, setUp, setupCPUCoreCount, setupSpins, 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 Detail

TRUSTSTORE_PATH

public static final java.lang.String TRUSTSTORE_PATH

See Also:

Constant Field Values

TRUSTSTORE_PASSWORD

public static final java.lang.String TRUSTSTORE_PASSWORD

See Also:

Constant Field Values

CLIENT_RETRY_TIMEOUT

public static final java.lang.String CLIENT_RETRY_TIMEOUT

See Also:

Constant Field Values

CLIENT_SOCKET_TIMEOUT

public static final java.lang.String CLIENT_SOCKET_TIMEOUT

See Also:

Constant Field Values

Constructor Detail

ESRestTestCase

public ESRestTestCase()

Method Detail

entityAsMap

public java.util.Map<java.lang.String,java.lang.Object> entityAsMap(Response response)
                                                             throws java.io.IOException

Convert the entity from a Response into a map of maps.

Throws:

java.io.IOException

initClient

public void initClient()
                throws java.io.IOException

Throws:

java.io.IOException

cleanUpCluster

public final void cleanUpCluster()
                          throws java.lang.Exception

Clean up after the test case.

Throws:

java.lang.Exception

closeClients

public static void closeClients()
                         throws java.io.IOException

Throws:

java.io.IOException

client

protected static RestClient client()

Get the client used for ordinary api calls while writing a test

adminClient

protected static RestClient adminClient()

Get the client used for test administrative actions. Do not use this while writing a test. Only use it for cleaning up after tests.

preserveIndicesUponCompletion

protected boolean preserveIndicesUponCompletion()

Returns whether to preserve the indices created during this test on completion of this test. Defaults to false. Override this method if indices should be preserved after the test, with the assumption that some other process or test will clean up the indices afterward. This is useful if the data directory and indices need to be preserved between test runs (for example, when testing rolling upgrades).

preserveTemplatesUponCompletion

protected boolean preserveTemplatesUponCompletion()

Controls whether or not to preserve templates upon completion of this test. The default implementation is to delete not preserve templates.

Returns:

whether or not to preserve templates

preserveReposUponCompletion

protected boolean preserveReposUponCompletion()

Returns whether to preserve the repositories on completion of this test. Defaults to not preserving repos. See also preserveSnapshotsUponCompletion().

preserveSnapshotsUponCompletion

protected boolean preserveSnapshotsUponCompletion()

Returns whether to preserve the snapshots in repositories on completion of this test. Defaults to not preserving snapshots. Only works for fs repositories.

restClientSettings

protected Settings restClientSettings()

Used to obtain settings for the REST client that is used to send REST requests.

restAdminSettings

protected Settings restAdminSettings()

Returns the REST client settings used for admin actions like cleaning up after the test has completed.

getClusterHosts

protected final java.util.List<org.apache.http.HttpHost> getClusterHosts()

Get the list of hosts in the cluster.

getProtocol

protected java.lang.String getProtocol()

Override this to switch to testing https.

buildClient

protected RestClient buildClient(Settings settings,
                                 org.apache.http.HttpHost[] hosts)
                          throws java.io.IOException

Throws:

java.io.IOException

assertOK

protected void assertOK(Response response)

ensureGreen

protected void ensureGreen()
                    throws java.io.IOException

Throws:

java.io.IOException

createIndex

protected void createIndex(java.lang.String name,
                           Settings settings)
                    throws java.io.IOException

Throws:

java.io.IOException

createIndex

protected void createIndex(java.lang.String name,
                           Settings settings,
                           java.lang.String mapping)
                    throws java.io.IOException

Throws:

java.io.IOException