BatchGraph (Gremlin Core: The Primary Components of TinkerPop3 3.0.0.M7 API)

java.lang.Object
- com.tinkerpop.gremlin.structure.util.batch.BatchGraph<G>

All Implemented Interfaces:

Graph, Graph.Iterators, java.lang.AutoCloseable
```
public class BatchGraph<G extends Graph>
extends java.lang.Object
implements Graph, Graph.Iterators
```
BatchGraph is a wrapper that enables batch loading of a large number of edges and vertices by chunking the entire load into smaller batches and maintaining a sideEffects-efficient vertex cache so that the entire transactional state can be flushed after each chunk is loaded.
BatchGraph is ONLY meant for loading data and does not support any retrieval or removal operations. That is, BatchGraph only supports the following methods: - addVertex(Object...) for adding vertices - Vertex.addEdge(String, com.tinkerpop.gremlin.structure.Vertex, Object...) for adding edges - Graph.V(Object...) to be used when adding edges - Property getter, setter and removal methods for vertices and edges.
An important limitation of BatchGraph is that edge properties can only be set immediately after the edge has been added. If other vertices or edges have been created in the meantime, setting, getting or removing properties will throw exceptions. This is done to avoid caching of edges which would require a great amount of sideEffects.
BatchGraph can also automatically set the provided element ids as properties on the respective element. Use BatchGraph.Builder.vertexIdKey(String) and BatchGraph.Builder.edgeIdKey(String) to set the keys for the vertex and edge properties respectively. This allows to make the loaded baseGraph compatible for later operation with IdStrategy.
Note that BatchGraph itself is not a GraphStrategy because it requires that the Vertex implementation not hold on to the underlying Vertex reference and StrategyVertex does that by it's very nature. While it might be possible to work around this issue, it is likely better for performance to simply leave this as a "half-wrapper" implementation, instead of forcing it into a GraphStrategy.

Author:

Matthias Broecheler (http://www.matthiasb.com), Stephen Mallette (http://stephen.genoprime.com), Marko A. Rodriguez (http://markorodriguez.com)

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class BatchGraph.Builder<G extends Graph>
- Nested classes/interfaces inherited from interface com.tinkerpop.gremlin.structure.Graph
  Graph.Exceptions, Graph.Features, Graph.Helper, Graph.Hidden, Graph.Io, Graph.Iterators, Graph.OptIn, Graph.OptIns, Graph.OptOut, Graph.OptOuts, Graph.Variables

Nested Classes
Modifier and Type	Class and Description
`static class`	`BatchGraph.Builder<G extends Graph>`

Field Summary

Fields
Modifier and Type Field and Description

static long DEFAULT_BUFFER_SIZE
Default buffer size is 10000.
- Fields inherited from interface com.tinkerpop.gremlin.structure.Graph
  GRAPH

Fields
Modifier and Type	Field and Description
`static long`	`DEFAULT_BUFFER_SIZE` Default buffer size is 10000.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Vertex`	`addVertex(java.lang.Object... keyValues)` Add a `Vertex` to the graph given an optional series of key/value pairs.
`static <T extends Graph> BatchGraph.Builder`	`build(T g)`
`void`	`close()`
`GraphComputer`	`compute(java.lang.Class... graphComputerClass)` Create an OLAP `GraphComputer` to execute a vertex program over this graph.
`org.apache.commons.configuration.Configuration`	`configuration()` Get the `Configuration` associated with the construction of this graph.
`GraphTraversal<Edge,Edge>`	`E(java.lang.Object... edgeIds)` Starts a `GraphTraversal` over the edges in the graph.
`java.util.Iterator<Edge>`	`edgeIterator(java.lang.Object... edgeIds)` Get the `Edge` objects in this graph with the provided edge ids.
`Graph.Features`	`features()` Gets the `Graph.Features` exposed by the underlying `Graph` implementation.
`Graph.Iterators`	`iterators()` Get the `Graph.Iterators` associated with this graph.
`<T extends Traversal<S,S>,S> T`	`of(java.lang.Class<T> traversalClass)` Constructs a new domain specific `Traversal` for this graph.
`Transaction`	`tx()` Configure and control the transactions for those graphs that support this feature.
`Graph.Variables`	`variables()` A collection of global `Graph.Variables` associated with the graph.
`java.util.Iterator<Vertex>`	`vertexIterator(java.lang.Object... vertexIds)` Get the `Vertex` objects in this graph with the provided vertex ids.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.tinkerpop.gremlin.structure.Graph
addVertex, io, strategy, V

- Field Detail
  - DEFAULT_BUFFER_SIZE
```
public static final long DEFAULT_BUFFER_SIZE
```
    Default buffer size is 10000.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - addVertex
```
public Vertex addVertex(java.lang.Object... keyValues)
```
    Description copied from interface: Graph
    
    Add a Vertex to the graph given an optional series of key/value pairs. These key/values must be provided in an even number where the odd numbered arguments are String property keys and the even numbered arguments are the related property values.
    
    Specified by:
    
    addVertex in interface Graph
    
    Parameters:
    
    keyValues - The key/value pairs to turn into vertex properties
    
    Returns:
    
    The newly created vertex
  - E
```
public GraphTraversal<Edge,Edge> E(java.lang.Object... edgeIds)
```
    Description copied from interface: Graph
    
    Starts a GraphTraversal over the edges in the graph. If edgeIds are provided, then the traversal starts at those edges, else all edges in the graph.
    
    Specified by:
    
    E in interface Graph
    
    Parameters:
    
    edgeIds - the ids of the edges to get (if none are provided, get all edges)
    
    Returns:
    
    a graph traversal over the edges of the graph
  - iterators
```
public Graph.Iterators iterators()
```
    Description copied from interface: Graph
    
    Get the Graph.Iterators associated with this graph.
    
    Specified by:
    
    iterators in interface Graph
    
    Returns:
    
    the graph iterators of this graph
  - vertexIterator
```
public java.util.Iterator<Vertex> vertexIterator(java.lang.Object... vertexIds)
```
    Description copied from interface: Graph.Iterators
    
    Get the Vertex objects in this graph with the provided vertex ids. If no ids are provided, get all vertices.
    
    Specified by:
    
    vertexIterator in interface Graph.Iterators
    
    Parameters:
    
    vertexIds - the ids of the vertices to get
    
    Returns:
    
    an Iterator of vertices that match the provided vertex ids
  - edgeIterator
```
public java.util.Iterator<Edge> edgeIterator(java.lang.Object... edgeIds)
```
    Description copied from interface: Graph.Iterators
    
    Get the Edge objects in this graph with the provided edge ids. If no ids are provided, get all edges.
    
    Specified by:
    
    edgeIterator in interface Graph.Iterators
    
    Parameters:
    
    edgeIds - the ids of the edges to get
    
    Returns:
    
    an Iterator of edges that match the provided edge ids
  - of
```
public <T extends Traversal<S,S>,S> T of(java.lang.Class<T> traversalClass)
```
    Description copied from interface: Graph
    
    Constructs a new domain specific Traversal for this graph.
    
    Specified by:
    
    of in interface Graph
    
    Parameters:
    
    traversalClass - the domain specific Traversal bound to this graph
  - compute
```
public GraphComputer compute(java.lang.Class... graphComputerClass)
```
    Description copied from interface: Graph
    
    Create an OLAP GraphComputer to execute a vertex program over this graph. If the graph does not support graph computer then an UnsupportedOperationException is thrown. The provided arguments can be of either length 0 or 1. A graph can support multiple graph computers.
    
    Specified by:
    
    compute in interface Graph
    
    Parameters:
    
    graphComputerClass - The graph computer class to use (if no argument, then a default is selected by the graph)
    
    Returns:
    
    A graph computer for processing this graph
  - tx
```
public Transaction tx()
```
    Description copied from interface: Graph
    
    Configure and control the transactions for those graphs that support this feature.
    
    Specified by:
    
    tx in interface Graph
  - variables
```
public Graph.Variables variables()
```
    Description copied from interface: Graph
    
    A collection of global Graph.Variables associated with the graph. Variables are used for storing metadata about the graph.
    
    Specified by:
    
    variables in interface Graph
    
    Returns:
    
    The variables associated with this graph
  - configuration
```
public org.apache.commons.configuration.Configuration configuration()
```
    Description copied from interface: Graph
    
    Get the Configuration associated with the construction of this graph. Whatever configuration was passed to GraphFactory.open(org.apache.commons.configuration.Configuration) is what should be returned by this method.
    
    Specified by:
    
    configuration in interface Graph
    
    Returns:
    
    the configuration used during graph construction.
  - features
```
public Graph.Features features()
```
    Description copied from interface: Graph
    
    Gets the Graph.Features exposed by the underlying Graph implementation.
    
    Specified by:
    
    features in interface Graph
  - close
```
public void close()
           throws java.lang.Exception
```
    Specified by:
    
    close in interface java.lang.AutoCloseable
    
    Throws:
    
    java.lang.Exception
  - build
```
public static <T extends Graph> BatchGraph.Builder build(T g)
```

Class BatchGraph<G extends Graph>

Nested Class Summary

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

Field Summary

Fields inherited from interface com.tinkerpop.gremlin.structure.Graph

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.tinkerpop.gremlin.structure.Graph

Field Detail

DEFAULT_BUFFER_SIZE

Method Detail

addVertex

E

iterators

vertexIterator

edgeIterator

of

compute

tx

variables

configuration

features

close

build