com.tinkerpop.gremlin.process

Interface Step<S,E>

Type Parameters:

S - The incoming object type of the step

E - The outgoing object type of the step

All Superinterfaces:

java.lang.Cloneable, java.util.Iterator<Traverser<E>>

All Known Implementing Classes:

AbstractStep, AddEdgeStep, AggregateStep, BackStep, BarrierStep, BranchStep, ChooseStep, CoinStep, ComputerAwareStep, ComputerResultStep, CountStep, CyclicPathStep, DedupStep, EdgeOtherVertexStep, EdgeVertexStep, EmptyStep, ExceptStep, FilterStep, FlatMapStep, FoldStep, GraphStep, GroupCountStep, GroupStep, HasStep, IdentityStep, IdStep, InjectStep, KeyStep, LabelStep, LocalStep, MapStep, MarkerIdentityStep, MatchStep, OrderStep, PathIdentityStep, PathStep, ProfileStep, PropertiesStep, PropertyElementStep, PropertyMapStep, PropertyValueStep, RangeStep, RepeatStep, RetainStep, RouteStep, SackElementValueStep, SackObjectStep, SackStep, SampleStep, SelectOneStep, SelectStep, ShuffleStep, SideEffectCapStep, SideEffectStep, SimplePathStep, StartStep, StoreStep, StrategyGraphStep, SubgraphStep, SumStep, TimeLimitStep, TreeStep, UnfoldStep, UnionStep, VertexStep, WhereStep

public interface Step<S,E>
extends java.util.Iterator<Traverser<E>>, java.lang.Cloneable

A Step denotes a unit of computation within a Traversal. A step takes an incoming object and yields an outgoing object. Steps are chained together in a Traversal to yield a lazy function chain of computation.

In the constructor of a Step, never store explicit sideEffect objects in TraversalSideEffects. If a sideEffect needs to be registered with the Traversal, use SideEffects.registerSupplier().

Method Summary

Modifier and Type	Method and Description
void	addStart(Traverser<S> start) Add a single Traverser to the step.
void	addStarts(java.util.Iterator<Traverser<S>> starts) Add a iterator of Traverser objects of type S to the step.
Step<S,E>	clone() Cloning is used to duplicate steps for the purpose of traversal optimization and OLTP replication.
java.lang.String	getId() Get the unique id of this step.
java.util.Optional<java.lang.String>	getLabel() Get the label of this step.
Step<E,?>	getNextStep() Get the next step to the current step.
Step<?,S>	getPreviousStep() Get the step prior to the current step.
default java.util.Set<TraverserRequirement>	getRequirements() Provide the necessary TraverserRequirement that must be met by the traverser in order for the step to function properly.
<A,B> Traversal<A,B>	getTraversal() Get the Traversal that this step is contained within.
void	reset() Reset the state of the step such that it has no incoming starts.
void	setId(java.lang.String id) Get the unique id of the step.
void	setLabel(java.lang.String label) Set the label of this step.
void	setNextStep(Step<E,?> step) Set the step that is next to the current step.
void	setPreviousStep(Step<?,S> step) Set the step that is previous to the current step.
void	setTraversal(Traversal<?,?> traversal) Set the Traversal that this step is contained within.

Methods inherited from interface java.util.Iterator

forEachRemaining, hasNext, next, remove

Method Detail

addStarts

void addStarts(java.util.Iterator<Traverser<S>> starts)

Add a iterator of Traverser objects of type S to the step.

Parameters:

starts - The iterator of objects to add

addStart

void addStart(Traverser<S> start)

Add a single Traverser to the step.

Parameters:

start - The traverser to add

setPreviousStep

void setPreviousStep(Step<?,S> step)

Set the step that is previous to the current step. Used for linking steps together to form a function chain.

Parameters:

step - the previous step of this step

getPreviousStep

Step<?,S> getPreviousStep()

Get the step prior to the current step.

Returns:

The previous step

setNextStep

void setNextStep(Step<E,?> step)

Set the step that is next to the current step. Used for linking steps together to form a function chain.

Parameters:

step - the next step of this step

getNextStep

Step<E,?> getNextStep()

Get the next step to the current step.

Returns:

The next step

getTraversal

<A,B> Traversal<A,B> getTraversal()

Get the Traversal that this step is contained within.

Type Parameters:

A - The incoming object type of the traversal

B - The outgoing object type of the traversal

Returns:

The traversal of this step

setTraversal

void setTraversal(Traversal<?,?> traversal)

Set the Traversal that this step is contained within.

Parameters:

traversal - the new traversal for this step

reset

void reset()

Reset the state of the step such that it has no incoming starts. Internal states are to be reset, but any sideEffect data structures are not to be recreated.

clone

Step<S,E> clone()
         throws java.lang.CloneNotSupportedException

Cloning is used to duplicate steps for the purpose of traversal optimization and OLTP replication. When cloning a step, it is important that the steps, the cloned step is equivalent to the state of the step when reset() is called. Moreover, the previous and next steps should be set to EmptyStep.

Returns:

The cloned step

Throws:

java.lang.CloneNotSupportedException

getLabel

java.util.Optional<java.lang.String> getLabel()

Get the label of this step. If the step is not labeled, then an Optional.empty() is returned.

Returns:

the optional label of the step

setLabel

void setLabel(java.lang.String label)

Set the label of this step.

Parameters:

label - the label for this step

setId

void setId(java.lang.String id)

Get the unique id of the step. These ids can change when strategies are applied and anonymous traversals are embedded in the parent traversal. A developer should typically not need to call this method.

Parameters:

id - the unique id of the step

getId

java.lang.String getId()

Get the unique id of this step.

Returns:

the unique id of the step

getRequirements

default java.util.Set<TraverserRequirement> getRequirements()

Provide the necessary TraverserRequirement that must be met by the traverser in order for the step to function properly. The provided default implements returns an empty set.

Returns:

the set of requirements