edu.iu.dsc.tws.graphapi.vertex

Interface Vertex<I,V,E>

Type Parameters:

I - Vertex id

V - Vertex data

E - Edge data

All Known Implementing Classes:

DefaultVertex, SsspDefaultVertex

public interface Vertex<I,V,E>

Class which holds vertex id, data and edges.

Method Summary

Modifier and Type	Method and Description
void	addEdge(E edge) Add an edge for this vertex (happens immediately)
java.lang.Iterable<E>	getEdges() Get a read-only view of the out-edges of this vertex.
V	getEdgeValue(I targetVertexId) Return the value of the first edge with the given target vertex id, or null if there is no such edge.
I	getId() Get the vertex id.
int	getNumEdges() Get the number of outgoing edges on this vertex.
V	getValue() Get the vertex value (data stored with vertex)
void	initialize(I id, V value) Initialize id and value.
void	initialize(I id, V value, java.lang.Iterable<E> edges) Initialize id, value, and edges.
void	removeEdges(I targetVertexId) Removes all edges pointing to the given vertex id.
void	setEdges(java.lang.Iterable<E> edges) Set the outgoing edges for this vertex.
void	setEdgeValue(I targetVertexId, V edgeValue) If an edge to the target vertex exists, set it to the given edge value.
void	setValue(V value) Set the vertex data (immediately visible in the computation)

Method Detail

initialize

void initialize(I id,
                V value,
                java.lang.Iterable<E> edges)

Initialize id, value, and edges. This method (or the alternative form initialize(id, value)) must be called after instantiation, unless readFields() is called.

Parameters:

id - Vertex id

value - Vertex value

edges - Iterable of edges

initialize

void initialize(I id,
                V value)

Initialize id and value. Vertex edges will be empty. This method (or the alternative form initialize(id, value, edges)) must be called after instantiation, unless readFields() is called.

Parameters:

id - Vertex id

value - Vertex value

getId

I getId()

Get the vertex id.

Returns:

My vertex id.

getValue

V getValue()

Get the vertex value (data stored with vertex)

Returns:

Vertex value

setValue

void setValue(V value)

Set the vertex data (immediately visible in the computation)

Parameters:

value - Vertex data to be set

getNumEdges

int getNumEdges()

Get the number of outgoing edges on this vertex.

Returns:

the total number of outbound edges from this vertex

getEdges

java.lang.Iterable<E> getEdges()

Get a read-only view of the out-edges of this vertex. Note: edge objects returned by this iterable may be invalidated as soon as the next element is requested. Thus, keeping a reference to an edge almost always leads to undesired behavior. Accessing the edges with other methods (e.g., addEdge()) during iteration leads to undefined behavior.

Returns:

the out edges (sort order determined by subclass implementation).

setEdges

void setEdges(java.lang.Iterable<E> edges)

Set the outgoing edges for this vertex.

Parameters:

edges - Iterable of edges

getEdgeValue

V getEdgeValue(I targetVertexId)

Return the value of the first edge with the given target vertex id, or null if there is no such edge. Note: edge value objects returned by this method may be invalidated by the next call. Thus, keeping a reference to an edge value almost always leads to undesired behavior.

Parameters:

targetVertexId - Target vertex id

Returns:

Edge value (or null if missing)

setEdgeValue

void setEdgeValue(I targetVertexId,
                  V edgeValue)

If an edge to the target vertex exists, set it to the given edge value. This only makes sense with strict graphs.

Parameters:

targetVertexId - Target vertex id

edgeValue - Edge value

addEdge

void addEdge(E edge)

Add an edge for this vertex (happens immediately)

Parameters:

edge - Edge to add

removeEdges

void removeEdges(I targetVertexId)

Removes all edges pointing to the given vertex id.

Parameters:

targetVertexId - the target vertex id