Module com.github.moaxcp.graphs.core

Package com.github.moaxcp.graphs

Interface PropertyGraph.Edge<ID>

Type Parameters:

ID - type of identifier

All Known Implementing Classes:

AbstractPropertyGraph.SimpleEdge

Enclosing interface:

PropertyGraph<ID>

public static interface PropertyGraph.Edge<ID>

An edge between two vertices in a graph. Edge direction depends on graph type. If the graph is directed isDirected() will return true.

Method Summary

Modifier and Type	Method	Description
List<ID>	endpoints()	Returns ordered pair of endpoint ids.
<T> Optional<T>	findProperty(String name)	Returns Optional of a property.
Optional<ID>	getId()	Returns optional identifier of this edge.
default ID	getOppositeEndpoint(ID id)	Returns the opposite endpoint of this edge
<T> T	getProperty(String name)	Returns a property.
ID	getSource()	Returns vertex id of source endpoint.
ID	getTarget()	Returns vertex id of target endpoint.
PropertyGraph.Edge<ID>	id(ID id)	Sets identifier of this edge.
Map<String,Object>	inherited()	Returns an unmodifiable map of inherited properties
boolean	isDirected()	Returns true if this edge is directed.
Map<String,Object>	local()	Returns an unmodifiable map of local properties
PropertyGraph.Edge<ID>	property(String name, Object value)	Sets the value of a local property returning this edge.
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2)	Sets the value of 2 local properties returning this edge.
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3)
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3, String name4, Object value4)
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3, String name4, Object value4, String name5, Object value5)
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3, String name4, Object value4, String name5, Object value5, String name6, Object value6)
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3, String name4, Object value4, String name5, Object value5, String name6, Object value6, String name7, Object value7)
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3, String name4, Object value4, String name5, Object value5, String name6, Object value6, String name7, Object value7, String name8, Object value8)
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3, String name4, Object value4, String name5, Object value5, String name6, Object value6, String name7, Object value7, String name8, Object value8, String name9, Object value9)
PropertyGraph.Edge<ID>	property(String name1, Object value1, String name2, Object value2, String name3, Object value3, String name4, Object value4, String name5, Object value5, String name6, Object value6, String name7, Object value7, String name8, Object value8, String name9, Object value9, String name10, Object value10)
PropertyGraph.Edge<ID>	property(Map<String,Object> properties)
PropertyGraph.Edge<ID>	remove()	Removes this edge from the graph.
PropertyGraph.Edge<ID>	removeProperty(String name)	Removes property from local properties returning this edge.
void	setId(ID id)	Sets identifier of this edge.
void	setProperty(String name, Object value)	Sets the value of a local property.
void	setSource(ID source)	Sets vertex id of source endpoint.
void	setTarget(ID target)	Sets vertex id of source endpoint.
ID	source()	Returns vertex id of source endpoint.
PropertyGraph.Edge<ID>	source(ID source)	Sets vertex id of source endpoint.
PropertyGraph.Vertex<ID>	sourceVertex()	Returns source vertex
ID	target()	Returns vertex id of target endpoint.
PropertyGraph.Edge<ID>	target(ID target)	Sets vertex id of target endpoint.
PropertyGraph.Vertex<ID>	targetVertex()	Returns target vertex

Method Details

getId

Optional<ID> getId()

Returns optional identifier of this edge.

Returns:

optional identifier

setId

void setId(ID id)

Sets identifier of this edge.

Parameters:

id - of edge

Throws:

NullPointerException - if id is null

id

PropertyGraph.Edge<ID> id(ID id)

Sets identifier of this edge.

Parameters:

id - of edge

Returns:

this edge

Throws:

NullPointerException - if id is null

getSource

ID getSource()

Returns vertex id of source endpoint.

Returns:

id of source endpoint

setSource

void setSource(ID source)

Sets vertex id of source endpoint. If vertex does not exist it is created.

Parameters:

source - endpoint

Throws:

NullPointerException - if source is null

source

ID source()

Returns vertex id of source endpoint.

Returns:

id of source endpoint

source

PropertyGraph.Edge<ID> source(ID source)

Sets vertex id of source endpoint. If vertex does not exist it is created.

Parameters:

source - endpoint

Returns:

this edge

Throws:

NullPointerException - if source is null

getTarget

ID getTarget()

Returns vertex id of target endpoint.

Returns:

id of target endpoint

setTarget

void setTarget(ID target)

Sets vertex id of source endpoint. If vertex does not exist it is created.

Parameters:

target - endpoint

Throws:

NullPointerException - if target is null

target

ID target()

Returns vertex id of target endpoint.

Returns:

id of target endpoint

target

PropertyGraph.Edge<ID> target(ID target)

Sets vertex id of target endpoint. If vertex does not exist it is created.

Parameters:

target - endpoint

Returns:

this edge

endpoints

List<ID> endpoints()

Returns ordered pair of endpoint ids. source endpoint id is always first followed by target endpoint id.

Returns:

order pair of endpoints

getOppositeEndpoint

default ID getOppositeEndpoint(@NonNull
 ID id)

Returns the opposite endpoint of this edge

Parameters:

id - of one endpoint

Returns:

Throws:

NullPointerException - if id is null

IllegalArgumentException - if id is not one of the endpoints of this edge

sourceVertex

PropertyGraph.Vertex<ID> sourceVertex()

Returns source vertex

Returns:

source vertex

targetVertex

PropertyGraph.Vertex<ID> targetVertex()

Returns target vertex

Returns:

target vertex

isDirected

boolean isDirected()

Returns true if this edge is directed. This edge is always directed if the parent graph is directed.

Returns:

true if this edge is directed

findProperty

<T> Optional<T> findProperty(String name)

Returns Optional of a property. If the property does not exist the returned Optional is empty.

A property is resolved by first checking properties set on this edge. If the local property does not exist edgeProperties in the graph are checked.

Parameters:

name - of property

Returns:

optional of named property

Throws:

NullPointerException - if name is null

getProperty

<T> T getProperty(String name)

Returns a property. If the property does not exist null is returned.

A property is resolved by first checking properties set on this edge. If the local proeprty does not exist edgeProperties in the graph are checked.

Type Parameters:

T - return type of property

Parameters:

name - of property

Returns:

value of named property

Throws:

NullPointerException - if name is null

setProperty

void setProperty(String name,
 Object value)

Sets the value of a local property.

Parameters:

name - of property

value - of property

Throws:

NullPointerException - if name or value is null

property

PropertyGraph.Edge<ID> property(String name,
 Object value)

Sets the value of a local property returning this edge.

Parameters:

name - of property

value - of property

Returns:

this edge

Throws:

NullPointerException - if name or value is null

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2)

Sets the value of 2 local properties returning this edge. Properties are added in order.

Parameters:

name1 - of first property

value1 - of first property

name2 - of second property

value2 - of second property

Returns:

this edge

Throws:

NullPointerException - if name or value is null for any of the properties

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3)

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3,
 String name4,
 Object value4)

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3,
 String name4,
 Object value4,
 String name5,
 Object value5)

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3,
 String name4,
 Object value4,
 String name5,
 Object value5,
 String name6,
 Object value6)

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3,
 String name4,
 Object value4,
 String name5,
 Object value5,
 String name6,
 Object value6,
 String name7,
 Object value7)

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3,
 String name4,
 Object value4,
 String name5,
 Object value5,
 String name6,
 Object value6,
 String name7,
 Object value7,
 String name8,
 Object value8)

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3,
 String name4,
 Object value4,
 String name5,
 Object value5,
 String name6,
 Object value6,
 String name7,
 Object value7,
 String name8,
 Object value8,
 String name9,
 Object value9)

property

PropertyGraph.Edge<ID> property(String name1,
 Object value1,
 String name2,
 Object value2,
 String name3,
 Object value3,
 String name4,
 Object value4,
 String name5,
 Object value5,
 String name6,
 Object value6,
 String name7,
 Object value7,
 String name8,
 Object value8,
 String name9,
 Object value9,
 String name10,
 Object value10)

property

PropertyGraph.Edge<ID> property(Map<String,Object> properties)

removeProperty

PropertyGraph.Edge<ID> removeProperty(String name)

Removes property from local properties returning this edge.

Parameters:

name - of property

Returns:

this edge

Throws:

NullPointerException - if name is null

inherited

Map<String,Object> inherited()

Returns an unmodifiable map of inherited properties

Returns:

map of inherited properties

local

Map<String,Object> local()

Returns an unmodifiable map of local properties

Returns:

map of local properties

remove

PropertyGraph.Edge<ID> remove()

Removes this edge from the graph.

Returns:

this edge