Package org.goplanit.graph

Class EdgeImpl

java.lang.Object

org.goplanit.utils.id.IdAbleImpl

org.goplanit.utils.id.ExternalIdAbleImpl

org.goplanit.graph.GraphEntityImpl

org.goplanit.graph.EdgeImpl

All Implemented Interfaces:

Serializable, Cloneable, Comparable<IdAble>, Edge, GraphEntity, ExternalIdAble, IdAble, ManagedId

Direct Known Subclasses:

DirectedEdgeImpl

public class EdgeImpl
extends GraphEntityImpl
implements Edge

Edge class connecting two vertices via some geometry. Each edge has one or two underlying edge segments in a particular direction which may carry additional information for each particular direction of the edge.

Author:

markr

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected Map<String,Object>	inputProperties	Generic input property storage
protected Double	lengthInKm	Length of edge
protected org.locationtech.jts.geom.LineString	lineGeometry	The line geometry of this link if set
protected String	name	Name of the edge

Fields inherited from interface org.goplanit.utils.graph.Edge

EDGE_ID_CLASS

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	EdgeImpl(EdgeImpl edgeImpl)	Copy constructor, input properties are copied using serialisation/deserialisation because shallow copy is considered dangerous
protected	EdgeImpl(IdGroupingToken groupId, Vertex vertexA, Vertex vertexB)	Constructor which injects link lengths directly
protected	EdgeImpl(IdGroupingToken groupId, Vertex vertexA, Vertex vertexB, double lengthKm)	Constructor which injects link lengths directly

Method Summary

Modifier and Type	Method	Description
void	addInputProperty(String key, Object value)	Add a property from the original input that is not part of the readily available link members
EdgeImpl	clone()	Create a shallow copy of this entity
org.locationtech.jts.geom.LineString	getGeometry()	Collect the geometry of this line
Object	getInputProperty(String key)	Get input property by its key
double	getLengthKm()	Return length of this edge in km
String	getName()	get the name of the edge
Vertex	getVertexA()	Vertex A of the edge
Vertex	getVertexB()	Vertex B of the edge
boolean	removeVertex(Vertex vertex)	Remove vertex from edge
boolean	removeVertexA()	remove vertex A by setting it to null
boolean	removeVertexB()	remove vertex B by setting it to null
boolean	replace(Vertex vertexToReplace, Vertex vertexToReplaceWith)	Replace one of the vertices of the link
void	setGeometry(org.locationtech.jts.geom.LineString lineString)	set the geometry of this link as a line string
void	setLengthKm(double lengthInKm)	set length of this edge in km
void	setName(String name)	set the name of the edge
protected void	setVertexA(Vertex vertexA)	set vertex A
protected void	setVertexB(Vertex vertexB)	set vertex B
boolean	validate()	validate the contents of this edge

Methods inherited from class org.goplanit.graph.GraphEntityImpl

generateAndSetId, generateId, recreateManagedIds, toString

Methods inherited from class org.goplanit.utils.id.ExternalIdAbleImpl

getExternalId, getXmlId, setExternalId, setXmlId

Methods inherited from class org.goplanit.utils.id.IdAbleImpl

equals, generateAndSetId, getId, hashCode, setId

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.goplanit.utils.graph.Edge

createEnvelope, getIdClass, hasGeometry, hasName, hasVertex, isGeometryInAbDirection, transformGeometry

Methods inherited from interface org.goplanit.utils.id.ExternalIdAble

getExternalId, getXmlId, hasExternalId, hasXmlId, setExternalId, setXmlId

Methods inherited from interface org.goplanit.utils.id.IdAble

compareTo, getId, idEquals, idHashCode

Methods inherited from interface org.goplanit.utils.id.ManagedId

recreateManagedIds, resetChildManagedIdEntities

Field Detail

lineGeometry

protected org.locationtech.jts.geom.LineString lineGeometry

The line geometry of this link if set

inputProperties

protected Map<String,Object> inputProperties

Generic input property storage

name

protected String name

Name of the edge

lengthInKm

protected Double lengthInKm

Length of edge

Constructor Detail

EdgeImpl

protected EdgeImpl(IdGroupingToken groupId,
                   Vertex vertexA,
                   Vertex vertexB)

Constructor which injects link lengths directly

Parameters:

groupId - , contiguous id generation within this group for instances of this class

vertexA - first vertex in the link

vertexB - second vertex in the link

EdgeImpl

protected EdgeImpl(IdGroupingToken groupId,
                   Vertex vertexA,
                   Vertex vertexB,
                   double lengthKm)

Constructor which injects link lengths directly

Parameters:

groupId - , contiguous id generation within this group for instances of this class

vertexA - first vertex in the link

vertexB - second vertex in the link

lengthKm - length of the link

EdgeImpl

protected EdgeImpl(EdgeImpl edgeImpl)

Copy constructor, input properties are copied using serialisation/deserialisation because shallow copy is considered dangerous

Parameters:

edgeImpl - to copy

Method Detail

setVertexB

protected void setVertexB(Vertex vertexB)

set vertex B

Parameters:

vertexB - to set

setVertexA

protected void setVertexA(Vertex vertexA)

set vertex A

Parameters:

vertexA - to set

getGeometry

public org.locationtech.jts.geom.LineString getGeometry()

Collect the geometry of this line

Specified by:

getGeometry in interface Edge

Returns:

lineString

setGeometry

public void setGeometry(org.locationtech.jts.geom.LineString lineString)

set the geometry of this link as a line string

Specified by:

setGeometry in interface Edge

Parameters:

lineString - to set

removeVertex

public boolean removeVertex(Vertex vertex)

Remove vertex from edge

Specified by:

removeVertex in interface Edge

Parameters:

vertex - to remove

Returns:

true when successful false otherwise

removeVertexB

public boolean removeVertexB()

remove vertex B by setting it to null

Returns:

true

removeVertexA

public boolean removeVertexA()

remove vertex A by setting it to null

Returns:

true

addInputProperty

public void addInputProperty(String key,
                             Object value)

Add a property from the original input that is not part of the readily available link members

Specified by:

addInputProperty in interface Edge

Parameters:

key - (name) of input property

value - of input property

getInputProperty

public Object getInputProperty(String key)

Get input property by its key

Specified by:

getInputProperty in interface Edge

Parameters:

key - of input property

Returns:

value retrieved value of input property

getLengthKm

public double getLengthKm()

Return length of this edge in km

Specified by:

getLengthKm in interface Edge

Returns:

length of this edge in km

setLengthKm

public void setLengthKm(double lengthInKm)

set length of this edge in km

Specified by:

setLengthKm in interface Edge

Parameters:

lengthInKm - of this edge in km

getVertexA

public Vertex getVertexA()

Vertex A of the edge

Specified by:

getVertexA in interface Edge

Returns:

vertex A

getVertexB

public Vertex getVertexB()

Vertex B of the edge

Specified by:

getVertexB in interface Edge

Returns:

vertex B

getName

public String getName()

get the name of the edge

Specified by:

getName in interface Edge

Returns:

name

setName

public void setName(String name)

set the name of the edge

Specified by:

setName in interface Edge

Parameters:

name - to set

replace

public boolean replace(Vertex vertexToReplace,
                       Vertex vertexToReplaceWith)
                throws PlanItException

Replace one of the vertices of the link

Specified by:

replace in interface Edge

Parameters:

vertexToReplace - the vertex to replace

vertexToReplaceWith - the vertex to replace with

Returns:

true when replaced, false otherwise

Throws:

PlanItException - thrown if error

clone

public EdgeImpl clone()

Create a shallow copy of this entity

Specified by:

clone in interface Edge

Specified by:

clone in interface IdAble

Overrides:

clone in class ExternalIdAbleImpl

Returns:

shallow copy of entity

validate

public boolean validate()

validate the contents of this edge

Specified by:

validate in interface Edge

Returns:

true when valid, false otherwise