org.apache.tinkerpop.gremlin.process.computer.bulkloading

Class BulkLoaderVertexProgram

java.lang.Object

org.apache.tinkerpop.gremlin.process.computer.bulkloading.BulkLoaderVertexProgram

All Implemented Interfaces:

Cloneable, VertexProgram<Tuple>

public class BulkLoaderVertexProgram
extends Object
implements VertexProgram<Tuple>

Author:

Daniel Kuppitz (http://gremlin.guru)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BulkLoaderVertexProgram.Builder

Nested classes/interfaces inherited from interface org.apache.tinkerpop.gremlin.process.computer.VertexProgram

VertexProgram.Features

Field Summary

Fields

Modifier and Type	Field and Description
static String	BULK_LOADER_CLASS_CFG_KEY
static String	BULK_LOADER_VERTEX_ID_CFG_KEY
static String	BULK_LOADER_VERTEX_PROGRAM_CFG_PREFIX
static String	DEFAULT_BULK_LOADER_VERTEX_ID
static String	INTERMEDIATE_BATCH_SIZE_CFG_KEY
static String	KEEP_ORIGINAL_IDS_CFG_KEY
static String	USER_SUPPLIED_IDS_CFG_KEY
static String	WRITE_GRAPH_CFG_KEY

Fields inherited from interface org.apache.tinkerpop.gremlin.process.computer.VertexProgram

VERTEX_PROGRAM

Method Summary

Modifier and Type	Method and Description
static BulkLoaderVertexProgram.Builder	build()
VertexProgram<Tuple>	clone() When multiple workers on a single machine need VertexProgram instances, it is possible to use clone.
void	execute(Vertex sourceVertex, Messenger<Tuple> messenger, Memory memory) This method denotes the main body of the computation and is executed on each vertex in the graph.
Set<String>	getElementComputeKeys() The Element properties that will be mutated during the computation.
VertexProgram.Features	getFeatures()
Set<MessageScope>	getMessageScopes(Memory memory) This method returns all the MessageScope possibilities for a particular iteration of the vertex program.
GraphComputer.Persist	getPreferredPersist()
GraphComputer.ResultGraph	getPreferredResultGraph()
void	loadState(Graph graph, Configuration config) When it is necessary to load the state of the VertexProgram, this method is called.
void	setup(Memory memory) The method is called at the beginning of the computation.
void	storeState(Configuration config) When it is necessary to store the state of the VertexProgram, this method is called.
boolean	terminate(Memory memory) The method is called at the end of each iteration to determine if the computation is complete.
String	toString()
void	workerIterationEnd(Memory memory) This method is called at the end of each iteration of each "computational chunk." The set of vertices in the graph are typically not processed with full parallelism.
void	workerIterationStart(Memory memory) This method is called at the start of each iteration of each "computational chunk." The set of vertices in the graph are typically not processed with full parallelism.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.tinkerpop.gremlin.process.computer.VertexProgram

createVertexProgram, getMapReducers, getMemoryComputeKeys, getMessageCombiner

Field Detail

BULK_LOADER_VERTEX_PROGRAM_CFG_PREFIX

public static final String BULK_LOADER_VERTEX_PROGRAM_CFG_PREFIX

See Also:

Constant Field Values

BULK_LOADER_CLASS_CFG_KEY

public static final String BULK_LOADER_CLASS_CFG_KEY

BULK_LOADER_VERTEX_ID_CFG_KEY

public static final String BULK_LOADER_VERTEX_ID_CFG_KEY

INTERMEDIATE_BATCH_SIZE_CFG_KEY

public static final String INTERMEDIATE_BATCH_SIZE_CFG_KEY

KEEP_ORIGINAL_IDS_CFG_KEY

public static final String KEEP_ORIGINAL_IDS_CFG_KEY

USER_SUPPLIED_IDS_CFG_KEY

public static final String USER_SUPPLIED_IDS_CFG_KEY

WRITE_GRAPH_CFG_KEY

public static final String WRITE_GRAPH_CFG_KEY

DEFAULT_BULK_LOADER_VERTEX_ID

public static final String DEFAULT_BULK_LOADER_VERTEX_ID

See Also:

Constant Field Values

Method Detail

setup

public void setup(Memory memory)

Description copied from interface: VertexProgram

The method is called at the beginning of the computation. The method is global to the GraphComputer and as such, is not called for each vertex. During this stage, the Memory should be initialized to to its "start state."

Specified by:

setup in interface VertexProgram<Tuple>

Parameters:

memory - The global memory of the GraphComputer

loadState

public void loadState(Graph graph,
                      Configuration config)

Description copied from interface: VertexProgram

When it is necessary to load the state of the VertexProgram, this method is called. This is typically required when the VertexProgram needs to be serialized to another machine. Note that what is loaded is simply the instance state, not any processed data.

Specified by:

loadState in interface VertexProgram<Tuple>

Parameters:

graph - the graph that the VertexProgram will run against

config - the configuration to load the state of the VertexProgram from.

storeState

public void storeState(Configuration config)

Description copied from interface: VertexProgram

When it is necessary to store the state of the VertexProgram, this method is called. This is typically required when the VertexProgram needs to be serialized to another machine. Note that what is stored is simply the instance/configuration state, not any processed data. The default implementation provided simply stores the VertexProgram class name for reflective reconstruction. It is typically a good idea to VertexProgram.super.storeState().

Specified by:

storeState in interface VertexProgram<Tuple>

Parameters:

config - the configuration to store the state of the VertexProgram in.

workerIterationStart

public void workerIterationStart(Memory memory)

Description copied from interface: VertexProgram

This method is called at the start of each iteration of each "computational chunk." The set of vertices in the graph are typically not processed with full parallelism. The vertex set is split into subsets and a worker is assigned to call the VertexProgram.execute(org.apache.tinkerpop.gremlin.structure.Vertex, org.apache.tinkerpop.gremlin.process.computer.Messenger<M>, org.apache.tinkerpop.gremlin.process.computer.Memory) method. The default implementation is a no-op.

Specified by:

workerIterationStart in interface VertexProgram<Tuple>

Parameters:

memory - The memory at the start of the iteration.

workerIterationEnd

public void workerIterationEnd(Memory memory)

Description copied from interface: VertexProgram

This method is called at the end of each iteration of each "computational chunk." The set of vertices in the graph are typically not processed with full parallelism. The vertex set is split into subsets and a worker is assigned to call the VertexProgram.execute(org.apache.tinkerpop.gremlin.structure.Vertex, org.apache.tinkerpop.gremlin.process.computer.Messenger<M>, org.apache.tinkerpop.gremlin.process.computer.Memory) method. The default implementation is a no-op.

Specified by:

workerIterationEnd in interface VertexProgram<Tuple>

Parameters:

memory - The memory at the end of the iteration.

execute

public void execute(Vertex sourceVertex,
                    Messenger<Tuple> messenger,
                    Memory memory)

Description copied from interface: VertexProgram

This method denotes the main body of the computation and is executed on each vertex in the graph. This method is logically executed in parallel on all vertices in the graph. When the Memory is read, it is according to the aggregated state yielded in the previous iteration. When the Memory is written, the data will be aggregated at the end of the iteration for reading in the next iteration.

Specified by:

execute in interface VertexProgram<Tuple>

Parameters:

sourceVertex - the Vertex to execute the VertexProgram on

messenger - the messenger that moves data between vertices

memory - the shared state between all vertices in the computation

terminate

public boolean terminate(Memory memory)

Description copied from interface: VertexProgram

The method is called at the end of each iteration to determine if the computation is complete. The method is global to the GraphComputer and as such, is not called for each Vertex. The Memory maintains the aggregated data from the last execute() iteration.

Specified by:

terminate in interface VertexProgram<Tuple>

Parameters:

memory - The global memory of the GraphComputer

Returns:

whether or not to halt the computation

getElementComputeKeys

public Set<String> getElementComputeKeys()

Description copied from interface: VertexProgram

The Element properties that will be mutated during the computation. All properties in the graph are readable, but only the keys specified here are writable. The default is an empty set.

Specified by:

getElementComputeKeys in interface VertexProgram<Tuple>

Returns:

the set of element keys that will be mutated during the vertex program's execution

getMessageScopes

public Set<MessageScope> getMessageScopes(Memory memory)

Description copied from interface: VertexProgram

This method returns all the MessageScope possibilities for a particular iteration of the vertex program. The returned messages scopes are the scopes that will be used to send messages during the stated iteration. It is not a requirement that all stated messages scopes be used, just that it is possible that they be used during the iteration.

Specified by:

getMessageScopes in interface VertexProgram<Tuple>

Parameters:

memory - an immutable form of the Memory

Returns:

all possible message scopes during said vertex program iteration

clone

public VertexProgram<Tuple> clone()

Description copied from interface: VertexProgram

When multiple workers on a single machine need VertexProgram instances, it is possible to use clone. This will provide a speedier way of generating instances, over the VertexProgram.storeState(Configuration) and VertexProgram.loadState(org.apache.tinkerpop.gremlin.structure.Graph, Configuration) model. The default implementation simply returns the object as it assumes that the VertexProgram instance is a stateless singleton.

Specified by:

clone in interface VertexProgram<Tuple>

Overrides:

clone in class Object

Returns:

A clone of the VertexProgram object

getPreferredResultGraph

public GraphComputer.ResultGraph getPreferredResultGraph()

Specified by:

getPreferredResultGraph in interface VertexProgram<Tuple>

getPreferredPersist

public GraphComputer.Persist getPreferredPersist()

Specified by:

getPreferredPersist in interface VertexProgram<Tuple>

toString

public String toString()

Overrides:

toString in class Object

build

public static BulkLoaderVertexProgram.Builder build()

getFeatures

public VertexProgram.Features getFeatures()

Specified by:

getFeatures in interface VertexProgram<Tuple>