org.janusgraph.core

Interface Transaction

All Superinterfaces:

AutoCloseable, org.apache.tinkerpop.gremlin.structure.Graph, org.apache.tinkerpop.gremlin.structure.util.Host, SchemaInspector, SchemaManager

All Known Subinterfaces:

JanusGraph, JanusGraphTransaction

All Known Implementing Classes:

JanusGraphBlueprintsGraph, JanusGraphBlueprintsTransaction, StandardJanusGraph, StandardJanusGraphTx

public interface Transaction
extends org.apache.tinkerpop.gremlin.structure.Graph, SchemaManager

Transaction defines a transactional context for a JanusGraph. Since JanusGraph is a transactional graph database, all interactions with the graph are mitigated by a Transaction.

All vertex and edge retrievals are channeled by a graph transaction which bundles all such retrievals, creations and deletions into one transaction. A graph transaction is analogous to a database transaction. The isolation level and ACID support are configured through the storage backend, meaning whatever level of isolation is supported by the storage backend is mirrored by a graph transaction.

A graph transaction supports:

• Creating vertices, properties and edges
• Creating types
• Index-based retrieval of vertices
• Querying edges and vertices
• Aborting and committing transaction

Author:

Matthias Bröcheler (http://www.matthiasb.com)

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.tinkerpop.gremlin.structure.Graph

org.apache.tinkerpop.gremlin.structure.Graph.Exceptions, org.apache.tinkerpop.gremlin.structure.Graph.Features, org.apache.tinkerpop.gremlin.structure.Graph.Hidden, org.apache.tinkerpop.gremlin.structure.Graph.OptIn, org.apache.tinkerpop.gremlin.structure.Graph.OptIns, org.apache.tinkerpop.gremlin.structure.Graph.OptOut, org.apache.tinkerpop.gremlin.structure.Graph.OptOuts, org.apache.tinkerpop.gremlin.structure.Graph.Variables

Field Summary

Fields inherited from interface org.apache.tinkerpop.gremlin.structure.Graph

GRAPH

Method Summary

Modifier and Type	Method and Description
JanusGraphVertex	addVertex(Object... objects)
JanusGraphVertex	addVertex(String vertexLabel) Creates a new vertex in the graph with the vertex label named by the argument.
void	close()
JanusGraphIndexQuery	indexQuery(String indexName, String query) Returns a JanusGraphIndexQuery to query for vertices or edges against the specified indexing backend using the given query string.
MixedIndexCountQuery	mixedIndexCountQuery()
JanusGraphMultiVertexQuery<? extends JanusGraphMultiVertexQuery>	multiQuery(Collection<JanusGraphVertex> vertices)
JanusGraphMultiVertexQuery<? extends JanusGraphMultiVertexQuery>	multiQuery(JanusGraphVertex... vertices)
JanusGraphQuery<? extends JanusGraphQuery>	query()

Methods inherited from interface org.apache.tinkerpop.gremlin.structure.Graph

compute, compute, configuration, edges, features, io, traversal, traversal, tx, tx, variables, vertices

Methods inherited from interface org.apache.tinkerpop.gremlin.structure.util.Host

getHostingVertex

Methods inherited from interface org.janusgraph.core.schema.SchemaManager

addConnection, addProperties, addProperties, makeEdgeLabel, makePropertyKey, makeVertexLabel

Methods inherited from interface org.janusgraph.core.schema.SchemaInspector

containsEdgeLabel, containsPropertyKey, containsRelationType, containsVertexLabel, getEdgeLabel, getOrCreateEdgeLabel, getOrCreatePropertyKey, getOrCreatePropertyKey, getOrCreatePropertyKey, getOrCreateVertexLabel, getPropertyKey, getRelationType, getVertexLabel

Method Detail

addVertex

JanusGraphVertex addVertex(String vertexLabel)

Creates a new vertex in the graph with the vertex label named by the argument.

Specified by:

addVertex in interface org.apache.tinkerpop.gremlin.structure.Graph

Parameters:

vertexLabel - the name of the vertex label to use

Returns:

a new vertex in the graph created in the context of this transaction

addVertex

JanusGraphVertex addVertex(Object... objects)

Specified by:

addVertex in interface org.apache.tinkerpop.gremlin.structure.Graph

query

JanusGraphQuery<? extends JanusGraphQuery> query()

Returns:

See Also:

query()

mixedIndexCountQuery

MixedIndexCountQuery mixedIndexCountQuery()

Returns:

a mixed index count query which leverages mixed index for counts

See Also:

StandardJanusGraphTx.mixedIndexCountQuery()

indexQuery

JanusGraphIndexQuery indexQuery(String indexName,
                                String query)

Returns a JanusGraphIndexQuery to query for vertices or edges against the specified indexing backend using the given query string. The query string is analyzed and answered by the underlying storage backend.

Note, that using indexQuery may ignore modifications in the current transaction.

Parameters:

indexName - Name of the index to query as configured

query - Query string

Returns:

JanusGraphIndexQuery object to query the index directly

multiQuery

JanusGraphMultiVertexQuery<? extends JanusGraphMultiVertexQuery> multiQuery(JanusGraphVertex... vertices)

Returns:

See Also:

multiQuery(org.janusgraph.core.JanusGraphVertex...)

multiQuery

JanusGraphMultiVertexQuery<? extends JanusGraphMultiVertexQuery> multiQuery(Collection<JanusGraphVertex> vertices)

Returns:

See Also:

multiQuery(java.util.Collection)

close

void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface org.apache.tinkerpop.gremlin.structure.Graph