com.tinkerpop.blueprints.util

Class DefaultVertexQuery

java.lang.Object

com.tinkerpop.blueprints.util.DefaultQuery

com.tinkerpop.blueprints.util.DefaultVertexQuery

All Implemented Interfaces:

Query, VertexQuery

public class DefaultVertexQuery
extends DefaultQuery
implements VertexQuery

For those graph engines that do not support the low-level querying of the edges of a vertex, then DefaultVertexQuery can be used. DefaultVertexQuery assumes, at minimum, that Vertex.getOutEdges() and Vertex.getInEdges() is implemented by the respective Vertex.

Author:

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

Nested Class Summary

Nested classes/interfaces inherited from class com.tinkerpop.blueprints.util.DefaultQuery

DefaultQuery.HasContainer

Nested classes/interfaces inherited from interface com.tinkerpop.blueprints.Query

Query.Compare

Field Summary

Fields

Modifier and Type	Field and Description
protected Vertex	vertex

Fields inherited from class com.tinkerpop.blueprints.util.DefaultQuery

direction, hasContainers, labels, limit

Constructor Summary

Constructors

Constructor and Description
DefaultVertexQuery(Vertex vertex)

Method Summary

Methods

Modifier and Type	Method and Description
long	count() Execute the query and return the number of edges that are unfiltered.
VertexQuery	direction(Direction direction) The direction of the edges to retrieve.
Iterable<Edge>	edges() Execute the query and return the matching edges.
VertexQuery	has(String key) Filter out elements that do not have a property with provided key.
VertexQuery	has(String key, Object value) Filter out elements that do not have a property value equal to provided value.
VertexQuery	has(String key, Predicate predicate, Object value) Filter out the element if it does not have a property with a comparable value.
<T extends Comparable<T>> VertexQuery	has(String key, T value, Query.Compare compare) Filter out the element if it does not have a property with a comparable value.
VertexQuery	hasNot(String key) Filter out elements that have a property with provided key.
VertexQuery	hasNot(String key, Object value) Filter out elements that have a property value equal to provided value.
<T extends Comparable<?>> VertexQuery	interval(String key, T startValue, T endValue) Filter out the element of its property value is not within the provided interval.
VertexQuery	labels(String... labels) Filter out the edge if its label is not in set of provided labels.
VertexQuery	limit(int limit) Filter out the element if the take number of incident/adjacent elements to retrieve has already been reached.
Object	vertexIds() Return the raw ids of the vertices on the other end of the edges.
Iterable<Vertex>	vertices() Execute the query and return the vertices on the other end of the matching edges.

Methods inherited from class java.lang.Object

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

Field Detail

vertex

protected final Vertex vertex

Constructor Detail

DefaultVertexQuery

public DefaultVertexQuery(Vertex vertex)

Method Detail

has

public VertexQuery has(String key)

Description copied from interface: Query

Filter out elements that do not have a property with provided key.

Specified by:

has in interface Query

Specified by:

has in interface VertexQuery

Overrides:

has in class DefaultQuery

Parameters:

key - the key of the property

Returns:

the modified query object

hasNot

public VertexQuery hasNot(String key)

Description copied from interface: Query

Filter out elements that have a property with provided key.

Specified by:

hasNot in interface Query

Specified by:

hasNot in interface VertexQuery

Overrides:

hasNot in class DefaultQuery

Parameters:

key - the key of the property

Returns:

the modified query object

has

public VertexQuery has(String key,
              Object value)

Description copied from interface: Query

Filter out elements that do not have a property value equal to provided value.

Specified by:

has in interface Query

Specified by:

has in interface VertexQuery

Overrides:

has in class DefaultQuery

Parameters:

key - the key of the property

value - the value to check against

Returns:

the modified query object

hasNot

public VertexQuery hasNot(String key,
                 Object value)

Description copied from interface: Query

Filter out elements that have a property value equal to provided value.

Specified by:

hasNot in interface Query

Specified by:

hasNot in interface VertexQuery

Overrides:

hasNot in class DefaultQuery

Parameters:

key - the key of the property

value - the value to check against

Returns:

the modified query object

has

public VertexQuery has(String key,
              Predicate predicate,
              Object value)

Description copied from interface: Query

Filter out the element if it does not have a property with a comparable value.

Specified by:

has in interface Query

Specified by:

has in interface VertexQuery

Overrides:

has in class DefaultQuery

Parameters:

key - the key of the property

predicate - the comparator to use for comparison

value - the value to check against

Returns:

the modified query object

has

public <T extends Comparable<T>> VertexQuery has(String key,
                                        T value,
                                        Query.Compare compare)

Description copied from interface: Query

Filter out the element if it does not have a property with a comparable value.

Specified by:

has in interface Query

Specified by:

has in interface VertexQuery

Overrides:

has in class DefaultQuery

Parameters:

key - the key of the property

value - the value to check against

compare - the comparator to use for comparison

Returns:

the modified query object

interval

public <T extends Comparable<?>> VertexQuery interval(String key,
                                             T startValue,
                                             T endValue)

Description copied from interface: Query

Filter out the element of its property value is not within the provided interval.

Specified by:

interval in interface Query

Specified by:

interval in interface VertexQuery

Overrides:

interval in class DefaultQuery

Parameters:

key - the key of the property

startValue - the inclusive start value of the interval

endValue - the exclusive end value of the interval

Returns:

the modified query object

limit

public VertexQuery limit(int limit)

Description copied from interface: Query

Filter out the element if the take number of incident/adjacent elements to retrieve has already been reached.

Specified by:

limit in interface Query

Specified by:

limit in interface VertexQuery

Overrides:

limit in class DefaultQuery

Parameters:

limit - the take number of elements to return

Returns:

the modified query object

direction

public VertexQuery direction(Direction direction)

Description copied from interface: VertexQuery

The direction of the edges to retrieve.

Specified by:

direction in interface VertexQuery

Parameters:

direction - whether to retrieve the incoming, outgoing, or both directions

Returns:

the modified query object

labels

public VertexQuery labels(String... labels)

Description copied from interface: VertexQuery

Filter out the edge if its label is not in set of provided labels.

Specified by:

labels in interface VertexQuery

Parameters:

labels - the labels to check against

Returns:

the modified query object

edges

public Iterable<Edge> edges()

Description copied from interface: Query

Execute the query and return the matching edges.

Specified by:

edges in interface Query

Returns:

the unfiltered incident edges

vertices

public Iterable<Vertex> vertices()

Description copied from interface: Query

Execute the query and return the vertices on the other end of the matching edges.

Specified by:

vertices in interface Query

Returns:

the unfiltered adjacent vertices

count

public long count()

Description copied from interface: VertexQuery

Execute the query and return the number of edges that are unfiltered.

Specified by:

count in interface VertexQuery

Returns:

the number of unfiltered edges

vertexIds

public Object vertexIds()

Description copied from interface: VertexQuery

Return the raw ids of the vertices on the other end of the edges.

Specified by:

vertexIds in interface VertexQuery

Returns:

the raw ids of the vertices on the other end of the edges