org.openstreetmap.josm.data.osm

Class Relation

java.lang.Object

org.openstreetmap.josm.data.osm.AbstractPrimitive

org.openstreetmap.josm.data.osm.OsmPrimitive

org.openstreetmap.josm.data.osm.Relation

All Implemented Interfaces:

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

public final class Relation
extends OsmPrimitive
implements IRelation

A relation, having a set of tags and any number (0...n) of members.

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 BBox	bbox
private RelationMember[]	members

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

directionalKeyPredicate, 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
	Relation() Create a new relation with id 0
	Relation(long id) Creates a new relation for the given id.
protected	Relation(long id, boolean allowNegative)
	Relation(long id, int version) Creates new relation
	Relation(Relation clone) Create an identical clone of the argument (including the id)
	Relation(Relation 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.
void	addMember(int index, RelationMember member)
void	addMember(RelationMember member)
private BBox	calculateBBox(java.util.Set<PrimitiveId> visitedRelations)
private void	checkMembers()
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.
private void	fireMembersChanged()
RelationMember	firstMember() Returns the first member.
BBox	getBBox() Fetch the bounding box of the primitive
java.lang.String	getDisplayName(NameFormatter formatter) Replies the display name of a primitive formatted by formatter
OsmPrimitiveType	getDisplayType()
java.util.Collection<OsmPrimitive>	getIncompleteMembers() Replies a collection with the incomplete children this relation refers to.
RelationMember	getMember(int index)
long	getMemberId(int idx) Returns id of the member at given index.
java.util.Set<OsmPrimitive>	getMemberPrimitives() Replies the set of OsmPrimitives referred to by at least one member of this relation
<T extends OsmPrimitive> java.util.Collection<T>	getMemberPrimitives(java.lang.Class<T> tClass)
java.util.List<OsmPrimitive>	getMemberPrimitivesList()
java.util.Set<java.lang.String>	getMemberRoles() Returns the set of roles used in this relation.
java.util.List<RelationMember>	getMembers()
int	getMembersCount() Returns the number of members.
java.util.Collection<RelationMember>	getMembersFor(java.util.Collection<? extends OsmPrimitive> primitives) Obtains all members with member.member == primitive
OsmPrimitiveType	getMemberType(int idx) Returns type of the member at given index.
java.lang.String	getRole(int idx) Returns role of the member at given index.
OsmPrimitiveType	getType() Gets the type of object represented by this object.
boolean	hasEqualSemanticAttributes(OsmPrimitive other, boolean testInterestingTagsOnly)
boolean	hasIncompleteMembers() Determines if at least one child primitive is incomplete.
boolean	isBoundary() Determines if this relation is a boundary.
boolean	isMultipolygon() Determines if this relation behaves as a multipolygon.
boolean	isOutsideDownloadArea() Tests if this primitive lies outside of the downloaded area of its DataSet.
protected void	keysChangedImpl(java.util.Map<java.lang.String,java.lang.String> originalKeys) What to do, when the tags have changed by one of the tag-changing methods.
RelationMember	lastMember() Returns the last member.
void	load(PrimitiveData data) Loads (clone) this primitive from provided PrimitiveData
RelationMember	removeMember(int index) Removes member at specified position.
void	removeMembersFor(java.util.Collection<? extends OsmPrimitive> primitives) removes all members with member.member == primitive
void	removeMembersFor(OsmPrimitive primitive) removes all members with member.member == primitive
RelationData	save() Save parameters of this primitive to the transport object
(package private) void	setDataset(DataSet dataSet) This method should never ever by called from somewhere else than Dataset.addPrimitive or removePrimitive methods
void	setDeleted(boolean deleted) Sets whether this primitive is deleted or not.
RelationMember	setMember(int index, RelationMember member) Replace member at position specified by index.
void	setMembers(java.util.List<RelationMember> members)
java.lang.String	toString()
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, hasEqualSemanticAttributes, hasEqualTechnicalAttributes, hashCode, hasSameInterestingTags, isAnnotated, isDisabled, isDisabledAndHidden, isDrawable, isHighlighted, isMemberOfSelected, isOuterMemberOfSelected, isReferredByWays, isSelectable, isSelected, isTagged, isUninterestingKey, mergeFrom, put, remove, removeAll, removeReferrer, reversedDirection, saveCommonAttributes, setChangesetId, setDisabledState, setDisabledType, setHiddenType, setHighlighted, setIncomplete, setKeys, setKeys, setModified, setOsmId, setTimestamp, setUser, setVisible, unsetDisabledState, updateFlags, visitReferrers, writeLock, writeUnlock

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

cloneFrom, generateUniqueId, get, getChangesetId, 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, setModified, setOsmId, setRawTimestamp, 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

members

private RelationMember[] members

bbox

private BBox bbox

Constructor Detail

Relation

protected Relation(long id,
                   boolean allowNegative)

Relation

public Relation()

Create a new relation with id 0

Relation

public Relation(Relation clone,
                boolean clearMetadata)

Constructs an identical clone of the argument.

Parameters:

clone - The relation to clone

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

Relation

public Relation(Relation clone)

Create an identical clone of the argument (including the id)

Parameters:

clone - The relation to clone, including its id

Relation

public Relation(long id)

Creates a new relation for the given id. If the id > 0, the way is marked as incomplete.

Parameters:

id - the id. > 0 required

Throws:

java.lang.IllegalArgumentException - if id < 0

Relation

public Relation(long id,
                int version)

Creates new relation

Parameters:

id - the id

version - version number (positive integer)

Method Detail

getMembers

public java.util.List<RelationMember> getMembers()

Returns:

Members of the relation. Changes made in returned list are not mapped back to the primitive, use setMembers() to modify the members

Since:

1925

setMembers

public void setMembers(java.util.List<RelationMember> members)

Parameters:

members - Can be null, in that case all members are removed

Since:

1925

getMembersCount

public int getMembersCount()

Description copied from interface: IRelation

Returns the number of members.

Specified by:

getMembersCount in interface IRelation

Returns:

number of members

getMember

public RelationMember getMember(int index)

addMember

public void addMember(RelationMember member)

addMember

public void addMember(int index,
                      RelationMember member)

setMember

public RelationMember setMember(int index,
                                RelationMember member)

Replace member at position specified by index.

Parameters:

index - index (positive integer)

member - relation member to set

Returns:

Member that was at the position

removeMember

public RelationMember removeMember(int index)

Removes member at specified position.

Parameters:

index - index (positive integer)

Returns:

Member that was at the position

getMemberId

public long getMemberId(int idx)

Description copied from interface: IRelation

Returns id of the member at given index.

Specified by:

getMemberId in interface IRelation

Parameters:

idx - member index

Returns:

id of the member at given index

getRole

public java.lang.String getRole(int idx)

Description copied from interface: IRelation

Returns role of the member at given index.

Specified by:

getRole in interface IRelation

Parameters:

idx - member index

Returns:

role of the member at given index

getMemberType

public OsmPrimitiveType getMemberType(int idx)

Description copied from interface: IRelation

Returns type of the member at given index.

Specified by:

getMemberType in interface IRelation

Parameters:

idx - member index

Returns:

type of the member at given index

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

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 RelationData 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

compareTo

public int compareTo(OsmPrimitive o)

Specified by:

compareTo in interface java.lang.Comparable<OsmPrimitive>

firstMember

public RelationMember firstMember()

Returns the first member.

Returns:

first member, or null

lastMember

public RelationMember lastMember()

Returns the last member.

Returns:

last member, or null

removeMembersFor

public void removeMembersFor(OsmPrimitive primitive)

removes all members with member.member == primitive

Parameters:

primitive - the primitive to check for

setDeleted

public void setDeleted(boolean deleted)

Description copied from interface: IPrimitive

Sets whether this primitive is deleted or not. Also marks this primitive as modified if deleted is true.

Specified by:

setDeleted in interface IPrimitive

Overrides:

setDeleted in class OsmPrimitive

Parameters:

deleted - true, if this primitive is deleted; false, otherwise

getMembersFor

public java.util.Collection<RelationMember> getMembersFor(java.util.Collection<? extends OsmPrimitive> primitives)

Obtains all members with member.member == primitive

Parameters:

primitives - the primitives to check for

Returns:

all relation members for the given primitives

removeMembersFor

public void removeMembersFor(java.util.Collection<? extends OsmPrimitive> primitives)

removes all members with member.member == primitive

Parameters:

primitives - the primitives to check for

Since:

5613

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

getMemberPrimitives

public java.util.Set<OsmPrimitive> getMemberPrimitives()

Replies the set of OsmPrimitives referred to by at least one member of this relation

Returns:

the set of OsmPrimitives referred to by at least one member of this relation

getMemberPrimitives

public <T extends OsmPrimitive> java.util.Collection<T> getMemberPrimitives(java.lang.Class<T> tClass)

getMemberPrimitivesList

public java.util.List<OsmPrimitive> getMemberPrimitivesList()

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

getDisplayType

public OsmPrimitiveType getDisplayType()

Overrides:

getDisplayType in class AbstractPrimitive

isBoundary

public boolean isBoundary()

Determines if this relation is a boundary.

Returns:

true if a boundary relation

isMultipolygon

public boolean isMultipolygon()

Determines if this relation behaves as a multipolygon.

Returns:

true if it's a real mutlipolygon or a boundary 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

calculateBBox

private BBox calculateBBox(java.util.Set<PrimitiveId> visitedRelations)

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

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

checkMembers

private void checkMembers()
                   throws DataIntegrityProblemException

Throws:

DataIntegrityProblemException

fireMembersChanged

private void fireMembersChanged()
                         throws DataIntegrityProblemException

Throws:

DataIntegrityProblemException

hasIncompleteMembers

public boolean hasIncompleteMembers()

Determines if at least one child primitive is incomplete.

Returns:

true if at least one child primitive is incomplete

getIncompleteMembers

public java.util.Collection<OsmPrimitive> getIncompleteMembers()

Replies a collection with the incomplete children this relation refers to.

Returns:

the incomplete children. Empty collection if no children are incomplete.

keysChangedImpl

protected void keysChangedImpl(java.util.Map<java.lang.String,java.lang.String> originalKeys)

Description copied from class: AbstractPrimitive

What to do, when the tags have changed by one of the tag-changing methods.

Overrides:

keysChangedImpl in class OsmPrimitive

Parameters:

originalKeys - original tags

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.

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

getMemberRoles

public java.util.Set<java.lang.String> getMemberRoles()

Returns the set of roles used in this relation.

Returns:

the set of roles used in this relation. Can be empty but never null

Since:

7556