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.

Field Summary

Fields

Modifier and Type	Field and Description
private double	east
private double	lat
private double	lon
private double	north

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

allPredicate, FLAG_ANNOTATED, FLAG_DIRECTION_REVERSED, FLAG_DISABLED, FLAG_DISABLED_TYPE, FLAG_HAS_DIRECTIONS, FLAG_HIDDEN_TYPE, FLAG_HIDE_IF_DISABLED, FLAG_HIGHLIGHTED, FLAG_TAGGED, isSelectablePredicate, isUsablePredicate, mappaintCacheIdx, mappaintStyle, modifiedPredicate, multipolygonPredicate, nodePredicate, nonDeletedCompletePredicate, nonDeletedPhysicalPredicate, nonDeletedPredicate, relationPredicate, wayPredicate

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

changesetId, FLAG_DELETED, FLAG_INCOMPLETE, FLAG_MODIFIED, 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)
void	accept(Visitor visitor) Implementation of the visitor scheme.
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()
java.lang.String	getDisplayName(NameFormatter formatter) Replies the display name of a primitive formatted by formatter
EastNorth	getEastNorth() Replies the projected east/north coordinates.
OsmPrimitiveType	getType() Gets the type of object represented by this object.
boolean	hasEqualSemanticAttributes(OsmPrimitive other) Replies true if this primitive and other are equal with respect to their semantic attributes.
void	invalidateEastNorthCache() Invoke to invalidate the internal cache of projected east/north coordinates.
boolean	isConnectedTo(java.util.Collection<Node> otherNodes, int hops, 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, Predicate<Node> predicate, java.util.Set<Node> visited)
boolean	isConnectionNode() Check whether this node connects 2 ways.
boolean	isDrawable()
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)
protected 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)
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, getParentRelations, getReferrer, getReferrers, getReferrers, getTemplateKeys, getTemplateValue, getUninterestingKeys, getWorkInProgressKeys, hasAreaTags, hasDirectionKeys, hasEqualTechnicalAttributes, hashCode, hasSameInterestingTags, isAnnotated, isDisabled, isDisabledAndHidden, isHighlighted, isMemberOfSelected, isOuterMemberOfSelected, isReferredByWays, isSelectable, isSelected, isTagged, isUninterestingKey, keysChangedImpl, put, remove, removeAll, removeReferrer, reversedDirection, saveCommonAttributes, setChangesetId, setDeleted, setDisabledState, setDisabledType, setHiddenType, setHighlighted, setIncomplete, setKeys, 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, getTimestamp, getUniqueId, getUser, getVersion, hasKey, hasKeys, hasTag, hasTag, hasTag, isDeleted, isIncomplete, isKeyFalse, isKeyTrue, isModified, isNew, isNewOrUndeleted, isTimestampEmpty, isUndeleted, isUsable, isVisible, keySet, setModified

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, getTimestamp, getUser, getVersion, isDeleted, isIncomplete, isModified, isNewOrUndeleted, isTimestampEmpty, isVisible, setChangesetId, setDeleted, setModified, setOsmId, setTimestamp, setUser, setVisible

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

get, getKeys, hasKeys, keySet, 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

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)
     throws java.lang.IllegalArgumentException

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)
     throws java.lang.IllegalArgumentException

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 final boolean isLatLonKnown()

Determines if this node has valid coordinates.

Returns:

true if this node has valid coordinates

Since:

7828

setCoor

public final void setCoor(LatLon coor)

Specified by:

setCoor in interface INode

setEastNorth

public final void setEastNorth(EastNorth eastNorth)

Specified by:

setEastNorth in interface INode

updateCoor

private void updateCoor(LatLon coor,
                        EastNorth eastNorth)

getCoor

public final LatLon getCoor()

Specified by:

getCoor in interface INode

getEastNorth

public final EastNorth getEastNorth()

Replies the projected east/north coordinates.

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

Caveat: doesn't listen to projection changes. Clients must invalidate the internal cache.

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()

setCoorInternal

protected void setCoorInternal(LatLon coor,
                               EastNorth eastNorth)

To be used only by Dataset.reindexNode

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

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)

Specified by:

accept in interface IPrimitive

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

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 - thrown if other is null.

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

DataIntegrityProblemException - thrown 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)

Description copied from class: OsmPrimitive

Replies true if this primitive and other are equal with respect to their semantic attributes.

1. equal id
2. both are complete or both are incomplete
3. both have the same tags

Overrides:

hasEqualSemanticAttributes in class OsmPrimitive

Returns:

true if this primitive and other are equal with respect to their semantic attributes.

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

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

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()

Overrides:

isDrawable in class OsmPrimitive

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,
                             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).

isConnectedTo

private boolean isConnectedTo(java.util.Collection<Node> otherNodes,
                              int hops,
                              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