com.tinkerpop.gremlin.process

Interface Path

All Superinterfaces:

java.lang.Cloneable

All Known Implementing Classes:

DetachedPath, EmptyPath, ImmutablePath, MutablePath, SparsePath

public interface Path
extends java.lang.Cloneable

A Path denotes a particular walk through a Graph as defined by a Traverser. In abstraction, any Path implementation maintains two lists: a list of sets of labels and a list of objects. The list of labels are the labels of the steps traversed. The list of objects are the objects traversed.

Author:

Marko A. Rodriguez (http://markorodriguez.com)

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Path.Exceptions

Method Summary

Modifier and Type	Method and Description
void	addLabel(java.lang.String label) Add label to the current head of the path.
Path	clone()
Path	extend(java.lang.Object object, java.lang.String... labels) Add a new step to the path with an object and any number of associated labels.
default void	forEach(java.util.function.BiConsumer<java.lang.Object,java.util.Set<java.lang.String>> consumer)
default void	forEach(java.util.function.Consumer<java.lang.Object> consumer)
default <A> A	get(int index) Get the object associated with the specified index into the path.
default <A> A	get(java.lang.String label) Get the object associated with the particular label of the path.
default boolean	hasLabel(java.lang.String label) Return true if the path has the specified label, else return false.
default boolean	isSimple() Determines whether the path is a simple or not.
java.util.List<java.util.Set<java.lang.String>>	labels() An ordered list of the labels associated with the path
java.util.List<java.lang.Object>	objects() An ordered list of the objects in the path.
default int	size() Get the number of step in the path.
default java.util.stream.Stream<org.javatuples.Pair<java.lang.Object,java.util.Set<java.lang.String>>>	stream()

Method Detail

size

default int size()

Get the number of step in the path.

Returns:

the size of the path

extend

Path extend(java.lang.Object object,
            java.lang.String... labels)

Add a new step to the path with an object and any number of associated labels.

Parameters:

object - the new head of the path

labels - the labels at the head of the path

Returns:

the extended path

get

default <A> A get(java.lang.String label)
           throws java.lang.IllegalArgumentException

Get the object associated with the particular label of the path. If the path as multiple labels of the type, then return a List of those objects.

Type Parameters:

A - the type of the object associated with the label

Parameters:

label - the label of the path

Returns:

the object associated with the label of the path

Throws:

java.lang.IllegalArgumentException - if the path does not contain the label

get

default <A> A get(int index)

Get the object associated with the specified index into the path.

Type Parameters:

A - the type of the object associated with the index

Parameters:

index - the index of the path

Returns:

the object associated with the index of the path

hasLabel

default boolean hasLabel(java.lang.String label)

Return true if the path has the specified label, else return false.

Parameters:

label - the label to search for

Returns:

true if the label exists in the path

addLabel

void addLabel(java.lang.String label)

Add label to the current head of the path.

Parameters:

label - the label to add to the head of the path

objects

java.util.List<java.lang.Object> objects()

An ordered list of the objects in the path.

Returns:

the objects of the path

labels

java.util.List<java.util.Set<java.lang.String>> labels()

An ordered list of the labels associated with the path

Returns:

the labels of the path

clone

Path clone()
    throws java.lang.CloneNotSupportedException

Throws:

java.lang.CloneNotSupportedException

isSimple

default boolean isSimple()

Determines whether the path is a simple or not. A simple path has no cycles and thus, no repeated objects.

Returns:

Whether the path is simple or not

forEach

default void forEach(java.util.function.Consumer<java.lang.Object> consumer)

forEach

default void forEach(java.util.function.BiConsumer<java.lang.Object,java.util.Set<java.lang.String>> consumer)

stream

default java.util.stream.Stream<org.javatuples.Pair<java.lang.Object,java.util.Set<java.lang.String>>> stream()