org.janusgraph.graphdb

Class JanusGraphIndexTest

java.lang.Object

org.janusgraph.graphdb.JanusGraphBaseTest

org.janusgraph.graphdb.JanusGraphIndexTest

All Implemented Interfaces:

JanusGraphBaseStoreFeaturesTest

public abstract class JanusGraphIndexTest
extends JanusGraphBaseTest

Author:

Matthias Broecheler (me@matthiasb.com)

Nested Class Summary

Nested classes/interfaces inherited from class org.janusgraph.graphdb.JanusGraphBaseTest

JanusGraphBaseTest.TestConfigOption

Field Summary

Fields

Modifier and Type	Field and Description
static String	EINDEX
static String	INDEX
static String	INDEX2
IndexFeatures	indexFeatures
static String	PINDEX
boolean	supportsGeoPoint
boolean	supportsNumeric
boolean	supportsText
static String	VINDEX

Fields inherited from class org.janusgraph.graphdb.JanusGraphBaseTest

config, DEFAULT_THREAD_COUNT, features, graph, ID_NAME, LABEL_NAME, logManagers, mgmt, readConfig, testInfo, tx

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JanusGraphIndexTest(boolean supportsGeoPoint, boolean supportsNumeric, boolean supportsText)

Method Summary

Modifier and Type	Method and Description
static void	assertGraphOfTheGods(JanusGraph graphOfTheGods)
void	clopen(Object... settings)
protected String[]	getIndexBackends()
String	getStringField(String propertyKey)
String	getTextField(String propertyKey)
void	open(WriteConfiguration config)
protected void	registerIndex(String indexName, Class<? extends org.apache.tinkerpop.gremlin.structure.Element> type, String... propertyNames)
void	shouldAwaitMultipleStatuses()
void	shouldUpdateIndexFieldsAfterIndexModification()
protected abstract boolean	supportsCollections()
protected boolean	supportsGeoCollections()
abstract boolean	supportsGeoPointExistsQuery()
abstract boolean	supportsGeoShapePrefixTreeMapping()
abstract boolean	supportsLuceneStyleQueries()
abstract boolean	supportsWildcardQuery()
void	testAndForceIndex()
void	testBooleanIndexing() Tests indexing boolean
void	testClearStorage() Ensure clearing storage actually removes underlying graph and index databases.
void	testCompositeAndMixedIndexing()
void	testCompositeVsMixedIndexing()
void	testConditionalIndexing() Tests conditional indexing and the different management features
void	testContainsWithMultipleValues()
void	testCreateMixedIndexThatPreviouslyExisted()
void	testDateIndexing() Tests indexing dates
void	testDeleteVertexThenAddProperty(org.junit.jupiter.api.TestInfo testInfo) Create a vertex and commit.
void	testDeleteVertexThenDeleteProperty(org.junit.jupiter.api.TestInfo testInfo) Create a vertex with an indexed property and commit.
void	testDeleteVertexThenModifyProperty(org.junit.jupiter.api.TestInfo testInfo) Create a vertex with an indexed property and commit.
void	testDisableAndDiscardManuallyAndDropEnabledIndex()
void	testDiscardAndDropRegisteredIndex()
void	testDiscardManuallyAndDropRegisteredIndex()
void	testDualMapping()
void	testEdgeTTLWithMixedIndices()
void	testExistsQuery() test exists query, i.e., has(key) query using all data types supported by mixed index, except Geoshape which has a separate test case
void	testForceRemoveElementFromMixedIndexShouldFailOnCompositeIndex()
void	testForceRemoveElementFromMixedIndexShouldFailOnWrongPropertiesUsed()
void	testGeoshapeExistsQuery()
void	testGraphCentricQueryProfiling()
void	testGraphOfTheGods() Tests the GraphOfTheGodsFactory.load(org.janusgraph.core.JanusGraph) method used as the standard example that ships with JanusGraph.
void	testIndexDataRetrievalWithLimitLessThenBatch()
void	testIndexing()
void	testIndexParameters() Tests index parameters (mapping and names) and various string predicates
void	testIndexQueryWithScore()
void	testIndexReplay()
void	testIndexSelectStrategy()
void	testIndexUpdatesWithoutReindex()
void	testInstantIndexing() Tests indexing instants
void	testListDeleteAddInOneTransaction()
void	testListIndexing() Tests indexing lists
void	testListUpdate()
void	testMixedIndexAggregatedCountReturnsCorrectResult()
void	testMixedIndexQueryFollowedByCount() Tests that if a given query can be satisfied by a single mixed index, and it is followed by a count step, then a count query will be built
void	testMultipleIndexBackends()
void	testMultipleOrClausesMixed()
void	testMultipleOrClausesMultipleMixed()
void	testNullQueries()
void	testOrderByWithRange() This test builds a mixed index and tests index queries with order and range/limit.
void	testOrForceIndexComposite()
void	testOrForceIndexMixedAndCompositeIndex()
void	testOrForceIndexPartialIndex()
void	testOrForceIndexUniqueMixedIndex()
void	testOrPartialIndex()
void	testRawQueries() Tests index parameters (mapping and names) with raw indexQuery
void	testRawQueriesWithParameters() Tests query parameters with raw indexQuery
void	testReenableDisabledIndex()
void	testSetIndexing() Tests indexing sets
void	testSetUpdate()
void	testSimpleUpdate()
void	testStaleEdgesAreSkippedFromMixedIndex()
void	testStaleGraphIndexForcePartialVertexRemoveByPropertyMap(boolean useMixedIndexMethod)
void	testStaleGraphIndexForceRemoveVertex(boolean withLabelConstraint)
void	testStaleMixedIndexForceFullVertexRemove()
void	testStaleMixedIndexForcePartialEdgeRemove()
void	testUpdateSchemaChangeNameForPropertyKey()
void	testUUIDIndexing() Tests indexing boolean
void	testVertexTTLWithMixedIndices()
void	testWidcardQuery() Tests indexing using _all virtual field

Methods inherited from class org.janusgraph.graphdb.JanusGraphBaseTest

assertMissing, asStream, clearGraph, close, closeLogManager, createExternalEdgeIndex, createExternalVertexIndex, disableIndex, discardIndex, dropIndex, enableIndex, evaluateQuery, evaluateQuery, evaluateQuery, evaluateQuery, evaluateQuery, evaluateQuery, evaluateQuery, executeScanJob, executeScanJob, finishSchema, getBackend, getConfig, getConfiguration, getE, getExternalIndex, getForceIndexGraph, getForceIndexGraph, getId, getOnlyEdge, getOnlyElement, getOnlyElement, getOnlyElement, getOnlyElement, getOnlyVertex, getStoreFeatures, getThreadCount, getV, getVertex, getVertex, getVertex, getVertex, makeKey, makeKeyedEdgeLabel, makeLabel, makeVertexIndexedKey, makeVertexIndexedUniqueKey, markIndexDiscarded, n, newTx, openTxLog, openUserLog, option, round, setUp, tearDown, validateConfigOptions, verifyElementOrder, verifyElementOrder, wrapAround

Methods inherited from class java.lang.Object

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

Field Detail

INDEX

public static final String INDEX

See Also:

Constant Field Values

VINDEX

public static final String VINDEX

See Also:

Constant Field Values

EINDEX

public static final String EINDEX

See Also:

Constant Field Values

PINDEX

public static final String PINDEX

See Also:

Constant Field Values

INDEX2

public static final String INDEX2

See Also:

Constant Field Values

supportsGeoPoint

public final boolean supportsGeoPoint

supportsNumeric

public final boolean supportsNumeric

supportsText

public final boolean supportsText

indexFeatures

public IndexFeatures indexFeatures

Constructor Detail

JanusGraphIndexTest

protected JanusGraphIndexTest(boolean supportsGeoPoint,
                              boolean supportsNumeric,
                              boolean supportsText)

Method Detail

getIndexBackends

protected String[] getIndexBackends()

supportsLuceneStyleQueries

public abstract boolean supportsLuceneStyleQueries()

supportsWildcardQuery

public abstract boolean supportsWildcardQuery()

supportsGeoPointExistsQuery

public abstract boolean supportsGeoPointExistsQuery()

supportsGeoShapePrefixTreeMapping

public abstract boolean supportsGeoShapePrefixTreeMapping()

getStringField

public String getStringField(String propertyKey)

getTextField

public String getTextField(String propertyKey)

open

public void open(WriteConfiguration config)

Overrides:

open in class JanusGraphBaseTest

clopen

public void clopen(Object... settings)

Overrides:

clopen in class JanusGraphBaseTest

testGraphOfTheGods

@Test
public void testGraphOfTheGods()

Tests the GraphOfTheGodsFactory.load(org.janusgraph.core.JanusGraph) method used as the standard example that ships with JanusGraph.

assertGraphOfTheGods

public static void assertGraphOfTheGods(JanusGraph graphOfTheGods)

testUpdateSchemaChangeNameForPropertyKey

@Test
public void testUpdateSchemaChangeNameForPropertyKey()

testMultipleIndexBackends

@Test
public void testMultipleIndexBackends()

testNullQueries

@Test
public void testNullQueries()

testClearStorage

@Test
public void testClearStorage()
                            throws Exception

Ensure clearing storage actually removes underlying graph and index databases.

Throws:

Exception

testGeoshapeExistsQuery

@Test
public void testGeoshapeExistsQuery()

testExistsQuery

@Test
public void testExistsQuery()

test exists query, i.e., has(key) query using all data types supported by mixed index, except Geoshape which has a separate test case

testSimpleUpdate

@Test
public void testSimpleUpdate()

testListUpdate

@Test
public void testListUpdate()

testSetUpdate

@Test
public void testSetUpdate()

testListDeleteAddInOneTransaction

@Test
public void testListDeleteAddInOneTransaction()

testIndexing

@Test
public void testIndexing()
                        throws InterruptedException

Throws:

InterruptedException

testBooleanIndexing

@Test
public void testBooleanIndexing()

Tests indexing boolean

testDateIndexing

@Test
public void testDateIndexing()

Tests indexing dates

testInstantIndexing

@Test
public void testInstantIndexing()

Tests indexing instants

testUUIDIndexing

@Test
public void testUUIDIndexing()

Tests indexing boolean

testConditionalIndexing

@Test
public void testConditionalIndexing()

Tests conditional indexing and the different management features

testGraphCentricQueryProfiling

@Test
public void testGraphCentricQueryProfiling()

testIndexSelectStrategy

@Test
public void testIndexSelectStrategy()

testCompositeVsMixedIndexing

@Test
public void testCompositeVsMixedIndexing()

testCompositeAndMixedIndexing

@Test
public void testCompositeAndMixedIndexing()

testIndexParameters

@Test
public void testIndexParameters()

Tests index parameters (mapping and names) and various string predicates

testMixedIndexQueryFollowedByCount

@Test
public void testMixedIndexQueryFollowedByCount()

Tests that if a given query can be satisfied by a single mixed index, and it is followed by a count step, then a count query will be built

testRawQueries

@Test
public void testRawQueries()

Tests index parameters (mapping and names) with raw indexQuery

testRawQueriesWithParameters

@Test
public void testRawQueriesWithParameters()

Tests query parameters with raw indexQuery

testDualMapping

@Test
public void testDualMapping()

testIndexReplay

@Tag(value="BRITTLE_TESTS")
 @Test
public void testIndexReplay()
                                                        throws Exception

Throws:

Exception

testIndexUpdatesWithoutReindex

public void testIndexUpdatesWithoutReindex()
                                    throws InterruptedException,
                                           ExecutionException

Throws:

InterruptedException

ExecutionException

testVertexTTLWithMixedIndices

@Test
public void testVertexTTLWithMixedIndices()
                                         throws Exception

Throws:

Exception

testEdgeTTLWithMixedIndices

@Test
public void testEdgeTTLWithMixedIndices()
                                       throws Exception

Throws:

Exception

testDeleteVertexThenDeleteProperty

@Test
public void testDeleteVertexThenDeleteProperty(org.junit.jupiter.api.TestInfo testInfo)
                                              throws BackendException

Create a vertex with an indexed property and commit. Open two new transactions; delete vertex in one and delete just the property in the other, then commit in the same order. Neither commit throws an exception.

Throws:

BackendException

testDeleteVertexThenAddProperty

@Test
public void testDeleteVertexThenAddProperty(org.junit.jupiter.api.TestInfo testInfo)
                                           throws BackendException

Create a vertex and commit. Open two new transactions; delete vertex in one and add an indexed property in the other, then commit in the same order. Neither commit throws an exception.

Throws:

BackendException

testDeleteVertexThenModifyProperty

@Test
public void testDeleteVertexThenModifyProperty(org.junit.jupiter.api.TestInfo testInfo)
                                              throws BackendException

Create a vertex with an indexed property and commit. Open two new transactions; delete vertex in one and modify the property in the other, then commit in the same order. Neither commit throws an exception.

Throws:

BackendException

testIndexQueryWithScore

@Test
public void testIndexQueryWithScore()
                                   throws InterruptedException

Throws:

InterruptedException

testContainsWithMultipleValues

@Test
public void testContainsWithMultipleValues()
                                          throws Exception

Throws:

Exception

testWidcardQuery

@Test
public void testWidcardQuery()

Tests indexing using _all virtual field

testListIndexing

@Test
public void testListIndexing()

Tests indexing lists

supportsCollections

protected abstract boolean supportsCollections()

supportsGeoCollections

protected boolean supportsGeoCollections()

testSetIndexing

@Test
public void testSetIndexing()

Tests indexing sets

shouldAwaitMultipleStatuses

@Test
public void shouldAwaitMultipleStatuses()
                                       throws InterruptedException,
                                              ExecutionException

Throws:

InterruptedException

ExecutionException

testAndForceIndex

@Test
public void testAndForceIndex()
                             throws Exception

Throws:

Exception

testOrForceIndexUniqueMixedIndex

@Test
public void testOrForceIndexUniqueMixedIndex()
                                            throws Exception

Throws:

Exception

testOrForceIndexMixedAndCompositeIndex

@Test
public void testOrForceIndexMixedAndCompositeIndex()
                                                  throws Exception

Throws:

Exception

testOrPartialIndex

@Test
public void testOrPartialIndex()

testOrForceIndexPartialIndex

@Test
public void testOrForceIndexPartialIndex()
                                        throws Exception

Throws:

Exception

testIndexDataRetrievalWithLimitLessThenBatch

@Test
public void testIndexDataRetrievalWithLimitLessThenBatch()
                                                        throws Exception

Throws:

Exception

testOrForceIndexComposite

@Test
public void testOrForceIndexComposite()
                                     throws Exception

Throws:

Exception

testOrderByWithRange

@Test
public void testOrderByWithRange()

This test builds a mixed index and tests index queries with order and range/limit. It also tests if index query cache is utilised correctly.

shouldUpdateIndexFieldsAfterIndexModification

public void shouldUpdateIndexFieldsAfterIndexModification()
                                                   throws InterruptedException,
                                                          ExecutionException

Throws:

InterruptedException

ExecutionException

testMultipleOrClausesMixed

@Test
public void testMultipleOrClausesMixed()

testMultipleOrClausesMultipleMixed

@Test
public void testMultipleOrClausesMultipleMixed()

testStaleGraphIndexForceRemoveVertex

@ParameterizedTest
 @ValueSource(booleans={true,false})
public void testStaleGraphIndexForceRemoveVertex(boolean withLabelConstraint)
                                                                                                  throws BackendException

Throws:

BackendException

testStaleMixedIndexForceFullVertexRemove

@Test
public void testStaleMixedIndexForceFullVertexRemove()
                                                    throws BackendException

Throws:

BackendException

testStaleMixedIndexForcePartialEdgeRemove

@Test
public void testStaleMixedIndexForcePartialEdgeRemove()
                                                     throws BackendException

Throws:

BackendException

testStaleGraphIndexForcePartialVertexRemoveByPropertyMap

@ParameterizedTest
 @ValueSource(booleans={true,false})
public void testStaleGraphIndexForcePartialVertexRemoveByPropertyMap(boolean useMixedIndexMethod)
                                                                                                                      throws BackendException

Throws:

BackendException

testForceRemoveElementFromMixedIndexShouldFailOnCompositeIndex

@Test
public void testForceRemoveElementFromMixedIndexShouldFailOnCompositeIndex()

testForceRemoveElementFromMixedIndexShouldFailOnWrongPropertiesUsed

@Test
public void testForceRemoveElementFromMixedIndexShouldFailOnWrongPropertiesUsed()
                                                                               throws BackendException

Throws:

BackendException

testDisableAndDiscardManuallyAndDropEnabledIndex

@Test
public void testDisableAndDiscardManuallyAndDropEnabledIndex()
                                                            throws Exception

Throws:

Exception

testDiscardManuallyAndDropRegisteredIndex

@Test
public void testDiscardManuallyAndDropRegisteredIndex()
                                                     throws Exception

Throws:

Exception

testDiscardAndDropRegisteredIndex

@Test
public void testDiscardAndDropRegisteredIndex()
                                             throws ExecutionException,
                                                    InterruptedException

Throws:

ExecutionException

InterruptedException

testReenableDisabledIndex

@Test
public void testReenableDisabledIndex()
                                     throws ExecutionException,
                                            InterruptedException

Throws:

ExecutionException

InterruptedException

testCreateMixedIndexThatPreviouslyExisted

@Test
public void testCreateMixedIndexThatPreviouslyExisted()
                                                     throws ExecutionException,
                                                            InterruptedException

Throws:

ExecutionException

InterruptedException

registerIndex

protected void registerIndex(String indexName,
                             Class<? extends org.apache.tinkerpop.gremlin.structure.Element> type,
                             String... propertyNames)
                      throws InterruptedException

Throws:

InterruptedException

testStaleEdgesAreSkippedFromMixedIndex

@Test
public void testStaleEdgesAreSkippedFromMixedIndex()

testMixedIndexAggregatedCountReturnsCorrectResult

@Test
public void testMixedIndexAggregatedCountReturnsCorrectResult()