org.openstreetmap.josm.data.osm

Class Node

java.lang.Object

org.openstreetmap.josm.data.osm.AbstractPrimitive

org.openstreetmap.josm.data.osm.OsmPrimitive

org.openstreetmap.josm.data.osm.Node

All Implemented Interfaces:

java.lang.Comparable<OsmPrimitive>, INode, IPrimitive, PrimitiveId, Tagged, TemplateEngineDataProvider

public final class Node
extends OsmPrimitive
implements INode

One node data, consisting of one world coordinate waypoint.

Nested Class Summary

Nested classes/interfaces inherited from class org.openstreetmap.josm.data.osm.AbstractPrimitive

AbstractPrimitive.KeyValueVisitor

Field Summary

Fields

Modifier and Type	Field and Description
private double	east
private java.lang.Object	eastNorthCacheKey The cache key to use for east and north.
private double	lat
private double	lon
private double	north

Fields inherited from class org.openstreetmap.josm.data.osm.OsmPrimitive

directionKeys, mappaintStyle

Fields inherited from class org.openstreetmap.josm.data.osm.AbstractPrimitive

changesetId, FLAG_ANNOTATED, FLAG_DELETED, FLAG_DIRECTION_REVERSED, FLAG_DISABLED, FLAG_DISABLED_TYPE, FLAG_HAS_DIRECTIONS, FLAG_HIDDEN_TYPE, FLAG_HIDE_IF_DISABLED, FLAG_HIGHLIGHTED, FLAG_INCOMPLETE, FLAG_MODIFIED, FLAG_TAGGED, FLAG_VISIBLE, flags, id, keys, timestamp, user, version

Constructor Summary

Constructors

Modifier	Constructor and Description
	Node() Constructs a new local Node with id 0.
	Node(EastNorth eastNorth) Constructs a new Node with the given east/north with id 0.
	Node(LatLon latlon) Constructs a new Node with the given lat/lon with id 0.
	Node(long id) Constructs an incomplete Node object with the given id.
protected	Node(long id, boolean allowNegative)
	Node(long id, int version) Constructs a new Node with the given id and version.
	Node(Node clone) Constructs an identical clone of the argument (including the id).
	Node(Node clone, boolean clearMetadata) Constructs an identical clone of the argument.

Method Summary

Modifier and Type	Method and Description
void	accept(PrimitiveVisitor visitor) Makes the given visitor visit this primitive.
void	accept(Visitor visitor) Implementation of the visitor scheme.
protected void	addToBBox(BBox box, java.util.Set<PrimitiveId> visited) If necessary, extend the bbox to contain this primitive
void	cloneFrom(OsmPrimitive osm) Get and write all attributes from the parameter.
int	compareTo(OsmPrimitive o)
boolean	concernsArea() Determines if this primitive semantically concerns an area.
BBox	getBBox() Fetch the bounding box of the primitive
LatLon	getCoor() Returns lat/lon coordinates of this node, or null unless isLatLonKnown()
java.lang.String	getDisplayName(NameFormatter formatter) Replies the display name of a primitive formatted by formatter
EastNorth	getEastNorth() Replies the projected east/north coordinates.
EastNorth	getEastNorth(Projection projection) Replies the projected east/north coordinates.
OsmPrimitiveType	getType() Gets the type of object represented by this object.
private boolean	hasEqualCoordinates(Node other)
boolean	hasEqualSemanticAttributes(OsmPrimitive other, boolean testInterestingTagsOnly)
void	invalidateEastNorthCache() Invoke to invalidate the internal cache of projected east/north coordinates.
boolean	isConnectedTo(java.util.Collection<Node> otherNodes, int hops, java.util.function.Predicate<Node> predicate) Tests whether this node is connected to otherNode via at most hops nodes matching the predicate (which may be null to consider all nodes).
private boolean	isConnectedTo(java.util.Collection<Node> otherNodes, int hops, java.util.function.Predicate<Node> predicate, java.util.Set<Node> visited)
boolean	isConnectionNode() Check whether this node connects 2 ways.
boolean	isDrawable() Determines if this object is drawable.
boolean	isLatLonKnown() Determines if this node has valid coordinates.
boolean	isOutsideDownloadArea() Tests if this primitive lies outside of the downloaded area of its DataSet.
void	load(PrimitiveData data) Loads (clone) this primitive from provided PrimitiveData
void	mergeFrom(OsmPrimitive other) Merges the technical and semantical attributes from other onto this.
NodeData	save() Save parameters of this primitive to the transport object
void	setCoor(LatLon coor) Sets lat/lon coordinates of this node.
(package private) void	setCoorInternal(LatLon coor, EastNorth eastNorth) To be used only by Dataset.reindexNode
(package private) void	setDataset(DataSet dataSet) This method should never ever by called from somewhere else than Dataset.addPrimitive or removePrimitive methods
void	setEastNorth(EastNorth eastNorth) Sets east/north coordinates of this node.
java.lang.String	toString()
private void	updateCoor(LatLon coor, EastNorth eastNorth)
void	updatePosition() Called by Dataset to update cached position information of primitive (bbox, cached EarthNorth, ...)

Methods inherited from class org.openstreetmap.josm.data.osm.OsmPrimitive

addReferrer, checkDataset, clearCachedStyle, clearOsmMetadata, equals, evaluateCondition, getDataSet, getDisabledType, getDiscardableKeys, getFilteredList, getFilteredSet, getFlagsAsString, getHiddenType, getInterestingTags, getMappaintCacheIdx, getParentRelations, getReferrer, getReferrers, getReferrers, getTemplateKeys, getTemplateValue, getUninterestingKeys, getWorkInProgressKeys, hasAreaTags, hasDirectionKeys, hasEqualSemanticAttributes, hasEqualSemanticFlags, hasEqualTechnicalAttributes, hashCode, hasSameInterestingTags, isAnnotated, isDisabled, isDisabledAndHidden, isHighlighted, isMemberOfSelected, isMultipolygon, isOuterMemberOfSelected, isReferredByWays, isSelectable, isSelected, isTagged, isUninterestingKey, keysChangedImpl, put, remove, removeAll, removeReferrer, reversedDirection, saveCommonAttributes, setChangesetId, setDeleted, setDisabledState, setDisabledType, setHiddenType, setHighlighted, setIncomplete, setKeys, setKeys, setMappaintCacheIdx, setModified, setOsmId, setTimestamp, setUser, setVisible, unsetDisabledState, updateFlags, visitReferrers, writeLock, writeUnlock

Methods inherited from class org.openstreetmap.josm.data.osm.AbstractPrimitive

cloneFrom, generateUniqueId, get, getChangesetId, getDisplayType, getId, getIgnoreCase, getKeys, getLocalName, getName, getNumKeys, getPrimitiveId, getRawTimestamp, getTimestamp, getUniqueId, getUser, getVersion, hasKey, hasKeys, hasTag, hasTag, hasTag, isDeleted, isIncomplete, isKeyFalse, isKeyTrue, isModified, isNew, isNewOrUndeleted, isTimestampEmpty, isUndeleted, isUsable, isVisible, keySet, setRawTimestamp, visitKeys

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openstreetmap.josm.data.osm.IPrimitive

getChangesetId, getId, getLocalName, getName, getPrimitiveId, getRawTimestamp, getTimestamp, getUser, getVersion, isDeleted, isIncomplete, isModified, isNewOrUndeleted, isTimestampEmpty, isUndeleted, isUsable, isVisible, setChangesetId, setDeleted, setModified, setOsmId, setRawTimestamp, setTimestamp, setUser, setVisible

Methods inherited from interface org.openstreetmap.josm.data.osm.Tagged

get, getKeys, hasKeys, keySet, put, put, remove, removeAll, setKeys

Methods inherited from interface org.openstreetmap.josm.data.osm.PrimitiveId

getUniqueId, isNew

Field Detail

lat

private double lat

lon

private double lon

east

private double east

north

private double north

eastNorthCacheKey

private java.lang.Object eastNorthCacheKey

The cache key to use for east and north.

Constructor Detail

Node

protected Node(long id,
               boolean allowNegative)

Node

public Node()

Constructs a new local Node with id 0.

Node

public Node(long id)

Constructs an incomplete Node object with the given id.

Parameters:

id - The id. Must be >= 0

Throws:

java.lang.IllegalArgumentException - if id < 0

Node

public Node(long id,
            int version)

Constructs a new Node with the given id and version.

Parameters:

id - The id. Must be >= 0

version - The version

Throws:

java.lang.IllegalArgumentException - if id < 0

Node

public Node(Node clone,
            boolean clearMetadata)

Constructs an identical clone of the argument.

Parameters:

clone - The node to clone

clearMetadata - If true, clears the OSM id and other metadata as defined by OsmPrimitive.clearOsmMetadata(). If false, does nothing

Node

public Node(Node clone)

Constructs an identical clone of the argument (including the id).

Parameters:

clone - The node to clone, including its id

Node

public Node(LatLon latlon)

Constructs a new Node with the given lat/lon with id 0.

Parameters:

latlon - The LatLon coordinates

Node

public Node(EastNorth eastNorth)

Constructs a new Node with the given east/north with id 0.

Parameters:

eastNorth - The EastNorth coordinates

Method Detail

isLatLonKnown

public boolean isLatLonKnown()

Determines if this node has valid coordinates.

Returns:

true if this node has valid coordinates

Since:

7828

setCoor

public void setCoor(LatLon coor)

Description copied from interface: INode

Sets lat/lon coordinates of this node.

Specified by:

setCoor in interface INode

Parameters:

coor - lat/lon coordinates of this node

setEastNorth

public void setEastNorth(EastNorth eastNorth)

Description copied from interface: INode

Sets east/north coordinates of this node.

Specified by:

setEastNorth in interface INode

Parameters:

eastNorth - east/north coordinates of this node

updateCoor

private void updateCoor(LatLon coor,
                        EastNorth eastNorth)

getCoor

public LatLon getCoor()

Returns lat/lon coordinates of this node, or null unless isLatLonKnown()

Specified by:

getCoor in interface INode

Returns:

lat/lon coordinates of this node, or null unless isLatLonKnown()

getEastNorth

public EastNorth getEastNorth()

Replies the projected east/north coordinates.

Uses the global projection to project the lan/lon-coordinates. Internally caches the projected coordinates.

Replies null if this node doesn't know lat/lon-coordinates, i.e. because it is an incomplete node.

Specified by:

getEastNorth in interface INode

Returns:

the east north coordinates or null

See Also:

invalidateEastNorthCache()

getEastNorth

public EastNorth getEastNorth(Projection projection)

Replies the projected east/north coordinates.

The result of the last conversion is cached. The cache object is used as cache key.

Parameters:

projection - The projection to use.

Returns:

The projected east/north coordinates

Since:

10827

setCoorInternal

void setCoorInternal(LatLon coor,
                     EastNorth eastNorth)

To be used only by Dataset.reindexNode

Parameters:

coor - lat/lon

eastNorth - east/north

setDataset

void setDataset(DataSet dataSet)

Description copied from class: OsmPrimitive

This method should never ever by called from somewhere else than Dataset.addPrimitive or removePrimitive methods

Overrides:

setDataset in class OsmPrimitive

Parameters:

dataSet - the parent dataset

accept

public void accept(Visitor visitor)

Description copied from class: OsmPrimitive

Implementation of the visitor scheme. Subclasses have to call the correct visitor function.

Specified by:

accept in class OsmPrimitive

Parameters:

visitor - The visitor from which the visit() function must be called.

accept

public void accept(PrimitiveVisitor visitor)

Description copied from interface: IPrimitive

Makes the given visitor visit this primitive.

Specified by:

accept in interface IPrimitive

Parameters:

visitor - visitor

cloneFrom

public void cloneFrom(OsmPrimitive osm)

Description copied from class: OsmPrimitive

Get and write all attributes from the parameter. Does not fire any listener, so use this only in the data initializing phase

Overrides:

cloneFrom in class OsmPrimitive

Parameters:

osm - other primitive

mergeFrom

public void mergeFrom(OsmPrimitive other)

Merges the technical and semantical attributes from other onto this. Both this and other must be new, or both must be assigned an OSM ID. If both this and other have an assigend OSM id, the IDs have to be the same.

Overrides:

mergeFrom in class OsmPrimitive

Parameters:

other - the other primitive. Must not be null.

Throws:

java.lang.IllegalArgumentException - if other is null.

DataIntegrityProblemException - if either this is new and other is not, or other is new and this is not

DataIntegrityProblemException - if other is new and other.getId() != this.getId()

load

public void load(PrimitiveData data)

Description copied from class: OsmPrimitive

Loads (clone) this primitive from provided PrimitiveData

Overrides:

load in class OsmPrimitive

Parameters:

data - The object which should be cloned

save

public NodeData save()

Description copied from class: OsmPrimitive

Save parameters of this primitive to the transport object

Specified by:

save in class OsmPrimitive

Returns:

The saved object data

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hasEqualSemanticAttributes

public boolean hasEqualSemanticAttributes(OsmPrimitive other,
                                          boolean testInterestingTagsOnly)

Overrides:

hasEqualSemanticAttributes in class OsmPrimitive

hasEqualCoordinates

private boolean hasEqualCoordinates(Node other)

compareTo

public int compareTo(OsmPrimitive o)

Specified by:

compareTo in interface java.lang.Comparable<OsmPrimitive>

getDisplayName

public java.lang.String getDisplayName(NameFormatter formatter)

Description copied from class: OsmPrimitive

Replies the display name of a primitive formatted by formatter

Specified by:

getDisplayName in class OsmPrimitive

Parameters:

formatter - formatter to use

Returns:

the display name

getType

public OsmPrimitiveType getType()

Description copied from interface: PrimitiveId

Gets the type of object represented by this object.

Specified by:

getType in interface PrimitiveId

Returns:

the object type

See Also:

Node, Way, Relation

getBBox

public BBox getBBox()

Description copied from class: OsmPrimitive

Fetch the bounding box of the primitive

Specified by:

getBBox in class OsmPrimitive

Returns:

Bounding box of the object

addToBBox

protected void addToBBox(BBox box,
                         java.util.Set<PrimitiveId> visited)

Description copied from class: OsmPrimitive

If necessary, extend the bbox to contain this primitive

Specified by:

addToBBox in class OsmPrimitive

Parameters:

box - a bbox instance

visited - a set of visited members or null

updatePosition

public void updatePosition()

Description copied from class: OsmPrimitive

Called by Dataset to update cached position information of primitive (bbox, cached EarthNorth, ...)

Specified by:

updatePosition in class OsmPrimitive

isDrawable

public boolean isDrawable()

Description copied from class: OsmPrimitive

Determines if this object is drawable.

A primitive is complete if all conditions are met:

• type and id is known
• tags are known
• it is not deleted
• it is not hidden by a filter
• for nodes: lat/lon are known
• for ways: all nodes are known and complete
• for relations: all members are known and complete

Overrides:

isDrawable in class OsmPrimitive

Returns:

true if this object is drawable

isConnectionNode

public boolean isConnectionNode()

Check whether this node connects 2 ways.

Returns:

true if isReferredByWays(2) returns true

See Also:

OsmPrimitive.isReferredByWays(int)

invalidateEastNorthCache

public void invalidateEastNorthCache()

Invoke to invalidate the internal cache of projected east/north coordinates. Coordinates are reprojected on demand when the getEastNorth() is invoked next time.

concernsArea

public boolean concernsArea()

Description copied from class: OsmPrimitive

Determines if this primitive semantically concerns an area.

Specified by:

concernsArea in class OsmPrimitive

Returns:

true if this primitive semantically concerns an area, according to its type, geometry and tags, false otherwise.

isConnectedTo

public boolean isConnectedTo(java.util.Collection<Node> otherNodes,
                             int hops,
                             java.util.function.Predicate<Node> predicate)

Tests whether this node is connected to otherNode via at most hops nodes matching the predicate (which may be null to consider all nodes).

Parameters:

otherNodes - other nodes

hops - number of hops

predicate - predicate to match

Returns:

true if this node mets the conditions

isConnectedTo

private boolean isConnectedTo(java.util.Collection<Node> otherNodes,
                              int hops,
                              java.util.function.Predicate<Node> predicate,
                              java.util.Set<Node> visited)

isOutsideDownloadArea

public boolean isOutsideDownloadArea()

Description copied from class: OsmPrimitive

Tests if this primitive lies outside of the downloaded area of its DataSet.

Specified by:

isOutsideDownloadArea in class OsmPrimitive

Returns:

true if this primitive lies outside of the downloaded area