org.openstreetmap.josm.data.osm.history

Class HistoryOsmPrimitive

java.lang.Object

org.openstreetmap.josm.data.osm.history.HistoryOsmPrimitive

All Implemented Interfaces:

java.lang.Comparable<HistoryOsmPrimitive>, Tagged

Direct Known Subclasses:

HistoryNode, HistoryRelation, HistoryWay

public abstract class HistoryOsmPrimitive
extends java.lang.Object
implements Tagged, java.lang.Comparable<HistoryOsmPrimitive>

Represents an immutable OSM primitive in the context of a historical view on OSM data.

Since:

1670

Field Summary

Fields

Modifier and Type	Field and Description
private Changeset	changeset
private long	changesetId
private long	id
private java.util.Map<java.lang.String,java.lang.String>	tags
private java.util.Date	timestamp
private User	user
private long	version
private boolean	visible

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

MAX_TAG_LENGTH

Constructor Summary

Constructors

Constructor and Description
HistoryOsmPrimitive(long id, long version, boolean visible, User user, long changesetId, java.util.Date timestamp) Constructs a new HistoryOsmPrimitive.
HistoryOsmPrimitive(long id, long version, boolean visible, User user, long changesetId, java.util.Date timestamp, boolean checkHistoricParams) Constructs a new HistoryOsmPrimitive with a configurable checking of historic parameters.
HistoryOsmPrimitive(OsmPrimitive p) Constructs a new HistoryOsmPrimitive from an existing OsmPrimitive.

Method Summary

Modifier and Type	Method and Description
int	compareTo(HistoryOsmPrimitive o)
protected void	ensurePositiveLong(long value, java.lang.String name) Checks that value is positive.
boolean	equals(java.lang.Object obj)
protected void	fillPrimitiveCommonData(PrimitiveData data) Fills the attributes common to all primitives with values from this history.
static HistoryOsmPrimitive	forOsmPrimitive(OsmPrimitive p) Replies a new HistoryNode, HistoryWay or HistoryRelation from an existing OsmPrimitive.
java.lang.String	get(java.lang.String key) Replies the value of the given key; null, if there is no value for this key
Changeset	getChangeset() Returns the changeset for this history primitive.
long	getChangesetId() Returns the changeset id.
abstract java.lang.String	getDisplayName(HistoryNameFormatter formatter) Replies the display name of a primitive formatted by formatter
long	getId() Returns the id.
java.util.Map<java.lang.String,java.lang.String>	getKeys() Replies the map of key/value pairs.
java.lang.String	getLocalName() Replies the a localized name for this primitive given by the value of the tags (in this order) name:lang_COUNTRY_Variant of the current locale name:lang_COUNTRY of the current locale name:lang of the current locale name of the current locale null, if no such tag exists
java.lang.String	getName() Replies the name of this primitive.
int	getNumKeys() Gets the number of keys
PrimitiveId	getPrimitiveId() Returns the primitive id.
java.util.Map<java.lang.String,java.lang.String>	getTags() Replies the key/value map.
java.util.Date	getTimestamp() Returns the timestamp.
abstract OsmPrimitiveType	getType() Returns the primitive type.
User	getUser() Returns the user.
long	getVersion() Returns the version.
int	hashCode()
boolean	hasKey(java.lang.String key) Replies true if there is a tag with key key.
boolean	hasKeys() Replies true, if there is at least one key/value pair; false, otherwise
boolean	isVisible() Determines if the primitive is still visible.
java.util.Collection<java.lang.String>	keySet() Replies the set of keys
boolean	matches(long id) Determines if this history matches given id.
boolean	matches(long id, long version) Determines if this history matches given id and version.
void	put(java.lang.String key, java.lang.String value) Sets a key/value pairs
void	remove(java.lang.String key) Removes a given key/value pair
void	removeAll() Removes all tags
void	setChangeset(Changeset changeset) Sets the changeset for this history primitive.
void	setKeys(java.util.Map<java.lang.String,java.lang.String> keys) Sets the map of key/value pairs
void	setTags(java.util.Map<java.lang.String,java.lang.String> tags) Sets the tags for this history primitive.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

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

hasTag, hasTag, hasTag, hasTag, hasTagDifferent, hasTagDifferent, hasTagDifferent, isKeyFalse, isKeyTrue, put, visitKeys

Field Detail

id

private long id

visible

private boolean visible

user

private User user

changesetId

private long changesetId

changeset

private Changeset changeset

timestamp

private java.util.Date timestamp

version

private long version

tags

private java.util.Map<java.lang.String,java.lang.String> tags

Constructor Detail

HistoryOsmPrimitive

public HistoryOsmPrimitive(long id,
                           long version,
                           boolean visible,
                           User user,
                           long changesetId,
                           java.util.Date timestamp)

Constructs a new HistoryOsmPrimitive.

Parameters:

id - the id (> 0 required)

version - the version (> 0 required)

visible - whether the primitive is still visible

user - the user (!= null required)

changesetId - the changeset id (> 0 required)

timestamp - the timestamp (!= null required)

Throws:

java.lang.IllegalArgumentException - if preconditions are violated

HistoryOsmPrimitive

public HistoryOsmPrimitive(long id,
                           long version,
                           boolean visible,
                           User user,
                           long changesetId,
                           java.util.Date timestamp,
                           boolean checkHistoricParams)

Constructs a new HistoryOsmPrimitive with a configurable checking of historic parameters. This is needed to build virtual HistoryOsmPrimitives for modified primitives, which do not have a timestamp and a changeset id.

Parameters:

id - the id (> 0 required)

version - the version (> 0 required)

visible - whether the primitive is still visible

user - the user (!= null required)

changesetId - the changeset id (> 0 required if checkHistoricParams is true)

timestamp - the timestamp (!= null required if checkHistoricParams is true)

checkHistoricParams - if true, checks values of changesetId and timestamp

Throws:

java.lang.IllegalArgumentException - if preconditions are violated

Since:

5440

HistoryOsmPrimitive

public HistoryOsmPrimitive(OsmPrimitive p)

Constructs a new HistoryOsmPrimitive from an existing OsmPrimitive.

Parameters:

p - the primitive

Method Detail

forOsmPrimitive

public static HistoryOsmPrimitive forOsmPrimitive(OsmPrimitive p)

Replies a new HistoryNode, HistoryWay or HistoryRelation from an existing OsmPrimitive.

Parameters:

p - the primitive

Returns:

a new HistoryNode, HistoryWay or HistoryRelation from p.

getId

public long getId()

Returns the id.

Returns:

the id

getPrimitiveId

public PrimitiveId getPrimitiveId()

Returns the primitive id.

Returns:

the primitive id

isVisible

public boolean isVisible()

Determines if the primitive is still visible.

Returns:

true if the primitive is still visible

getUser

public User getUser()

Returns the user.

Returns:

the user

getChangesetId

public long getChangesetId()

Returns the changeset id.

Returns:

the changeset id

getTimestamp

public java.util.Date getTimestamp()

Returns the timestamp.

Returns:

the timestamp

getVersion

public long getVersion()

Returns the version.

Returns:

the version

ensurePositiveLong

protected final void ensurePositiveLong(long value,
                                        java.lang.String name)

Checks that value is positive.

Parameters:

value - value to check

name - parameter name for error message

Throws:

java.lang.IllegalArgumentException - if value <= 0

matches

public boolean matches(long id,
                       long version)

Determines if this history matches given id and version.

Parameters:

id - Primitive identifier

version - Primitive version

Returns:

true if this history matches given id and version

matches

public boolean matches(long id)

Determines if this history matches given id.

Parameters:

id - Primitive identifier

Returns:

true if this history matches given id

getType

public abstract OsmPrimitiveType getType()

Returns the primitive type.

Returns:

the primitive type

compareTo

public int compareTo(HistoryOsmPrimitive o)

Specified by:

compareTo in interface java.lang.Comparable<HistoryOsmPrimitive>

put

public final void put(java.lang.String key,
                      java.lang.String value)

Description copied from interface: Tagged

Sets a key/value pairs

Specified by:

put in interface Tagged

Parameters:

key - the key

value - the value. If null, removes the key/value pair.

get

public final java.lang.String get(java.lang.String key)

Description copied from interface: Tagged

Replies the value of the given key; null, if there is no value for this key

Specified by:

get in interface Tagged

Parameters:

key - the key

Returns:

the value

hasKey

public final boolean hasKey(java.lang.String key)

Description copied from interface: Tagged

Replies true if there is a tag with key key. The value could however be empty. See Tagged.hasTag(String) to check for non-empty tags.

Specified by:

hasKey in interface Tagged

Parameters:

key - the key

Returns:

true, if there is a tag with key key

See Also:

Tagged.hasTag(String)

getKeys

public final java.util.Map<java.lang.String,java.lang.String> getKeys()

Description copied from interface: Tagged

Replies the map of key/value pairs. Never null, but may be the empty map.

Specified by:

getKeys in interface Tagged

Returns:

the map of key/value pairs

setKeys

public final void setKeys(java.util.Map<java.lang.String,java.lang.String> keys)

Description copied from interface: Tagged

Sets the map of key/value pairs

Specified by:

setKeys in interface Tagged

Parameters:

keys - the map of key value pairs. If null, reset to the empty map.

remove

public final void remove(java.lang.String key)

Description copied from interface: Tagged

Removes a given key/value pair

Specified by:

remove in interface Tagged

Parameters:

key - the key

removeAll

public final void removeAll()

Description copied from interface: Tagged

Removes all tags

Specified by:

removeAll in interface Tagged

hasKeys

public final boolean hasKeys()

Description copied from interface: Tagged

Replies true, if there is at least one key/value pair; false, otherwise

Specified by:

hasKeys in interface Tagged

Returns:

true, if there is at least one key/value pair; false, otherwise

keySet

public final java.util.Collection<java.lang.String> keySet()

Description copied from interface: Tagged

Replies the set of keys

Specified by:

keySet in interface Tagged

Returns:

the set of keys

getNumKeys

public int getNumKeys()

Description copied from interface: Tagged

Gets the number of keys

Specified by:

getNumKeys in interface Tagged

Returns:

The number of keys set for this tagged object.

getTags

public java.util.Map<java.lang.String,java.lang.String> getTags()

Replies the key/value map.

Returns:

the key/value map

getChangeset

public Changeset getChangeset()

Returns the changeset for this history primitive.

Returns:

the changeset for this history primitive

setChangeset

public void setChangeset(Changeset changeset)

Sets the changeset for this history primitive.

Parameters:

changeset - the changeset for this history primitive

setTags

public void setTags(java.util.Map<java.lang.String,java.lang.String> tags)

Sets the tags for this history primitive. Removes all tags if tags is null.

Parameters:

tags - the tags. May be null.

getName

public java.lang.String getName()

Replies the name of this primitive. The default implementation replies the value of the tag name or null, if this tag is not present.

Returns:

the name of this primitive

getDisplayName

public abstract java.lang.String getDisplayName(HistoryNameFormatter formatter)

Replies the display name of a primitive formatted by formatter

Parameters:

formatter - The formatter used to generate a display name

Returns:

the display name

getLocalName

public java.lang.String getLocalName()

Replies the a localized name for this primitive given by the value of the tags (in this order)

• name:lang_COUNTRY_Variant of the current locale
• name:lang_COUNTRY of the current locale
• name:lang of the current locale
• name of the current locale

null, if no such tag exists

Returns:

the name of this primitive

fillPrimitiveCommonData

protected void fillPrimitiveCommonData(PrimitiveData data)

Fills the attributes common to all primitives with values from this history.

Parameters:

data - primitive data to fill

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object