AbstractPrimitive (JOSM)

java.lang.Object
- org.openstreetmap.josm.data.osm.AbstractPrimitive

All Implemented Interfaces:

java.lang.Comparable<IPrimitive>, IPrimitive, PrimitiveId, Stylable, Tagged

Direct Known Subclasses:

OsmPrimitive, PrimitiveData
```
public abstract class AbstractPrimitive
extends java.lang.Object
implements IPrimitive
```
Abstract class to represent common features of the datatypes primitives.

Since:

4099

Field Summary

Fields
Modifier and Type	Field and Description
`protected int`	`changesetId` The id of the changeset this primitive was last uploaded to.
`private static java.util.Collection<java.lang.String>`	`discardable`
`protected static short`	`FLAG_ANNOTATED` If the primitive is annotated with a tag such as note, fixme, etc.
`protected static short`	`FLAG_DELETED` An object that was deleted by the user.
`protected static short`	`FLAG_DIRECTION_REVERSED` This flag is only relevant if FLAG_HAS_DIRECTIONS is set.
`protected static short`	`FLAG_DISABLED` An object can be disabled by the filter mechanism.
`protected static short`	`FLAG_DISABLED_TYPE` Flag used internally by the filter mechanism.
`protected static short`	`FLAG_HAS_DIRECTIONS` This flag is set if the primitive is a way and according to the tags, the direction of the way is important.
`protected static short`	`FLAG_HIDDEN_TYPE` Flag used internally by the filter mechanism.
`protected static short`	`FLAG_HIDE_IF_DISABLED` This flag is only relevant if an object is disabled by the filter mechanism (i.e. FLAG_DISABLED is set).
`protected static short`	`FLAG_HIGHLIGHTED` When hovering over ways and nodes in add mode, the "target" objects are visually highlighted.
`protected static short`	`FLAG_INCOMPLETE` A primitive is incomplete if we know its id and type, but nothing more.
`protected static short`	`FLAG_MODIFIED` This flag shows, that the properties have been changed by the user and on upload the object will be send to the server.
`protected static short`	`FLAG_PRESERVED` Determines if the primitive is preserved from the filter mechanism.
`protected static short`	`FLAG_TAGGED` If the primitive is tagged.
`protected static short`	`FLAG_VISIBLE` This flag is false, if the object is marked as deleted on the server.
`protected short`	`flags` Put several boolean flags to one short int field to save memory.
`protected long`	`id` Unique identifier in OSM.
`private static java.util.concurrent.atomic.AtomicLong`	`idCounter`
`protected java.lang.String[]`	`keys` The key/value list for this primitive.
`protected int`	`timestamp` A time value, measured in seconds from the epoch, or in other words, a number of seconds that have passed since 1970-01-01T00:00:00Z
`private static java.util.Collection<java.lang.String>`	`uninteresting`
`protected User`	`user` User that last modified this primitive, as specified by the server.
`protected int`	`version` Contains the version number as returned by the API.
`private static java.util.Collection<java.lang.String>`	`workinprogress`

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

Constructor Summary

Constructors
Constructor and Description

AbstractPrimitive()

Constructors
Constructor and Description
`AbstractPrimitive()`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`advanceUniqueId(long newId)` Advances the current primitive unique id to skip a range of values.
`void`	`clearOsmMetadata()` Clears the metadata, including id and version known to the OSM API.
`void`	`cloneFrom(AbstractPrimitive other)` Get and write all attributes from the parameter.
`static long`	`currentUniqueId()` Returns the current primitive unique id.
`protected java.lang.String`	`doGet(java.lang.String key, java.util.function.BiPredicate<java.lang.String,java.lang.String> predicate)`
`(package private) static long`	`generateUniqueId()` Generates a new primitive unique id.
`java.lang.String`	`get(java.lang.String key)` Replies the value for key `key`.
`int`	`getChangesetId()` Replies the id of the changeset this primitive was last uploaded to.
`static java.util.Collection<java.lang.String>`	`getDiscardableKeys()` Returns a list of keys which have been deemed uninteresting to the point that they can be silently removed from data which is being edited.
`protected java.lang.String`	`getFlagsAsString()`
`long`	`getId()` Replies the id of this primitive.
`java.lang.String`	`getIgnoreCase(java.lang.String key)` Gets a key ignoring the case of the key
`java.util.Map<java.lang.String,java.lang.String>`	`getInterestingTags()` Returns `Tagged.getKeys()` for which `key` does not fulfill uninteresting criteria.
`TagMap`	`getKeys()` Replies the map of key/value pairs.
`int`	`getNumKeys()` Gets the number of keys
`int`	`getRawTimestamp()` Time of last modification to this object.
`java.util.Date`	`getTimestamp()` Time of last modification to this object.
`static java.util.Collection<java.lang.String>`	`getUninterestingKeys()` Returns a list of "uninteresting" keys that do not make an object "tagged".
`long`	`getUniqueId()` Gets a unique id representing this object.
`User`	`getUser()` Replies the user who has last touched this object.
`int`	`getVersion()` Replies the version number as returned by the API.
`static java.util.Collection<java.lang.String>`	`getWorkInProgressKeys()` Returns a list of "work in progress" keys that do not make an object "tagged" but "annotated".
`boolean`	`hasKey(java.lang.String... keys)` Replies true if this primitive has a tag any of the `keys`.
`boolean`	`hasKey(java.lang.String key)` Replies true if this primitive has a tag with key `key`.
`boolean`	`hasKeys()` Replies true, if the map of key/value pairs of this primitive is not empty.
`private static int`	`indexOfKey(java.lang.String[] keys, java.lang.String key)` Scans a key/value array for a given key.
`boolean`	`isDeleted()` Replies `true`, if the object has been deleted.
`boolean`	`isIncomplete()` Determines if this primitive is incomplete.
`boolean`	`isModified()` Replies `true` if the object has been modified since it was loaded from the server.
`boolean`	`isNew()` Determines if this primitive is new.
`boolean`	`isNewOrUndeleted()` Determines if this primitive is new or undeleted.
`boolean`	`isTimestampEmpty()` Determines if this primitive has no timestamp information.
`boolean`	`isUndeleted()` Replies `true` if the object has been deleted on the server and was undeleted by the user.
`static boolean`	`isUninterestingKey(java.lang.String key)` Determines if key is considered "uninteresting".
`boolean`	`isUsable()` Replies `true`, if the object is usable (i.e.
`boolean`	`isVisible()` Checks if object is known to the server.
`protected abstract 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.
`java.util.Collection<java.lang.String>`	`keySet()` Replies the set of keys
`void`	`put(java.lang.String key, java.lang.String value)` Set the given value to the given key.
`void`	`remove(java.lang.String key)` Remove the given key from the list
`void`	`removeAll()` Removes all keys from this primitive.
`void`	`setChangesetId(int changesetId)` Sets the changeset id of this primitive.
`void`	`setDeleted(boolean deleted)` Sets whether this primitive is deleted or not.
`protected void`	`setIncomplete(boolean incomplete)` If set to true, this object is incomplete, which means only the id and type is known (type is the objects instance class)
`void`	`setKeys(java.util.Map<java.lang.String,java.lang.String> keys)` Sets the keys of this primitives to the key/value pairs in `keys`.
`void`	`setKeys(TagMap keys)` Copy the keys from a TagMap.
`void`	`setModified(boolean modified)` Marks this primitive as being modified.
`void`	`setOsmId(long id, int version)` Sets the id and the version of this primitive if it is known to the OSM API.
`void`	`setRawTimestamp(int timestamp)` Sets time of last modification to this object
`void`	`setTimestamp(java.util.Date timestamp)` Sets time of last modification to this object
`void`	`setUser(User user)` Sets the user who has last touched this object.
`void`	`setVisible(boolean visible)` Sets whether this primitive is visible, i.e.
`protected void`	`updateFlags(short flag, boolean value)`
`void`	`visitKeys(KeyValueVisitor visitor)` Calls the visitor for every key/value pair.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.openstreetmap.josm.data.osm.IPrimitive
accept, getBBox, getDataSet, getDisplayName, getDisplayType, getLocalName, getName, getOsmId, getOsmPrimitiveId, getPrimitiveId, getReferrers, getReferrers, hasDirectionKeys, hasSameInterestingTags, isAnnotated, isDisabled, isDisabledAndHidden, isDrawable, isHighlighted, isMemberOfSelected, isMultipolygon, isOuterMemberOfSelected, isPreserved, isSelectable, isSelected, isTagged, reversedDirection, setHighlighted, visitReferrers

Methods inherited from interface org.openstreetmap.josm.data.osm.Tagged
hasTag, hasTag, hasTag, hasTag, hasTagDifferent, hasTagDifferent, hasTagDifferent, isKeyFalse, isKeyTrue, put

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

Methods inherited from interface org.openstreetmap.josm.data.osm.Stylable
clearCachedStyle, declareCachedStyleUpToDate, getCachedStyle, isCachedStyleUpToDate, setCachedStyle

Methods inherited from interface java.lang.Comparable
compareTo

- Field Detail
  - idCounter
```
private static final java.util.concurrent.atomic.AtomicLong idCounter
```
  - FLAG_MODIFIED
```
protected static final short FLAG_MODIFIED
```
    This flag shows, that the properties have been changed by the user and on upload the object will be send to the server.
    
    See Also:
    
    Constant Field Values
  - FLAG_VISIBLE
```
protected static final short FLAG_VISIBLE
```
    This flag is false, if the object is marked as deleted on the server.
    
    See Also:
    
    Constant Field Values
  - FLAG_DELETED
```
protected static final short FLAG_DELETED
```
    An object that was deleted by the user. Deleted objects are usually hidden on the map and a request for deletion will be send to the server on upload. An object usually cannot be deleted if it has non-deleted objects still referring to it.
    
    See Also:
    
    Constant Field Values
  - FLAG_INCOMPLETE
```
protected static final short FLAG_INCOMPLETE
```
    A primitive is incomplete if we know its id and type, but nothing more. Typically some members of a relation are incomplete until they are fetched from the server.
    
    See Also:
    
    Constant Field Values
  - FLAG_DISABLED
```
protected static final short FLAG_DISABLED
```
    An object can be disabled by the filter mechanism. Then it will show in a shade of gray on the map or it is completely hidden from the view. Disabled objects usually cannot be selected or modified while the filter is active.
    
    See Also:
    
    Constant Field Values
  - FLAG_HIDE_IF_DISABLED
```
protected static final short FLAG_HIDE_IF_DISABLED
```
    This flag is only relevant if an object is disabled by the filter mechanism (i.e. FLAG_DISABLED is set). Then it indicates, whether it is completely hidden or just shown in gray color. When the primitive is not disabled, this flag should be unset as well (for efficient access).
    
    See Also:
    
    Constant Field Values
  - FLAG_DISABLED_TYPE
```
protected static final short FLAG_DISABLED_TYPE
```
    Flag used internally by the filter mechanism.
    
    See Also:
    
    Constant Field Values
  - FLAG_HIDDEN_TYPE
```
protected static final short FLAG_HIDDEN_TYPE
```
    Flag used internally by the filter mechanism.
    
    See Also:
    
    Constant Field Values
  - FLAG_HAS_DIRECTIONS
```
protected static final short FLAG_HAS_DIRECTIONS
```
    This flag is set if the primitive is a way and according to the tags, the direction of the way is important. (e.g. one way street.)
    
    See Also:
    
    Constant Field Values
  - FLAG_TAGGED
```
protected static final short FLAG_TAGGED
```
    If the primitive is tagged. Some trivial tags like source=* are ignored here.
    
    See Also:
    
    Constant Field Values
  - FLAG_DIRECTION_REVERSED
```
protected static final short FLAG_DIRECTION_REVERSED
```
    This flag is only relevant if FLAG_HAS_DIRECTIONS is set. It shows, that direction of the arrows should be reversed. (E.g. oneway=-1.)
    
    See Also:
    
    Constant Field Values
  - FLAG_HIGHLIGHTED
```
protected static final short FLAG_HIGHLIGHTED
```
    When hovering over ways and nodes in add mode, the "target" objects are visually highlighted. This flag indicates that the primitive is currently highlighted.
    
    See Also:
    
    Constant Field Values
  - FLAG_ANNOTATED
```
protected static final short FLAG_ANNOTATED
```
    If the primitive is annotated with a tag such as note, fixme, etc. Match the "work in progress" tags in default map style.
    
    See Also:
    
    Constant Field Values
  - FLAG_PRESERVED
```
protected static final short FLAG_PRESERVED
```
    Determines if the primitive is preserved from the filter mechanism.
    
    See Also:
    
    Constant Field Values
  - flags
```
protected volatile short flags
```
    Put several boolean flags to one short int field to save memory. Other bits of this field are used in subclasses.
  - id
```
protected long id
```
    Unique identifier in OSM. This is used to identify objects on the server. An id of 0 means an unknown id. The object has not been uploaded yet to know what id it will get.
  - user
```
protected User user
```
    User that last modified this primitive, as specified by the server. Never changed by JOSM.
  - version
```
protected int version
```
    Contains the version number as returned by the API. Needed to ensure update consistency
  - changesetId
```
protected int changesetId
```
    The id of the changeset this primitive was last uploaded to. 0 if it wasn't uploaded to a changeset yet of if the changeset id isn't known.
  - timestamp
```
protected int timestamp
```
    A time value, measured in seconds from the epoch, or in other words, a number of seconds that have passed since 1970-01-01T00:00:00Z
  - keys
```
protected volatile java.lang.String[] keys
```
    The key/value list for this primitive.
    Note that the keys field is synchronized using RCU. Writes to it are not synchronized by this object, the writers have to synchronize writes themselves.
    In short this means that you should not rely on this variable being the same value when read again and your should always copy it on writes.
    Further reading:
    - CopyOnWriteArrayList
    - http://stackoverflow.com/questions/2950871/how-can-copyonwritearraylist-be-thread-safe
    - https://en.wikipedia.org/wiki/Read-copy-update (mind that we have a Garbage collector, rcu_assign_pointer and rcu_dereference are ensured by the volatile keyword)
  - workinprogress
```
private static volatile java.util.Collection<java.lang.String> workinprogress
```
  - uninteresting
```
private static volatile java.util.Collection<java.lang.String> uninteresting
```
  - discardable
```
private static volatile java.util.Collection<java.lang.String> discardable
```
- Constructor Detail
  - AbstractPrimitive
```
public AbstractPrimitive()
```
- Method Detail
  - generateUniqueId
```
static long generateUniqueId()
```
    Generates a new primitive unique id.
    
    Returns:
    
    new primitive unique (negative) id
  - currentUniqueId
```
public static long currentUniqueId()
```
    Returns the current primitive unique id.
    
    Returns:
    
    the current primitive unique (negative) id (last generated)
    
    Since:
    
    12536
  - advanceUniqueId
```
public static void advanceUniqueId(long newId)
```
    Advances the current primitive unique id to skip a range of values.
    
    Parameters:
    
    newId - new unique id
    
    Throws:
    
    java.lang.IllegalArgumentException - if newId is greater than current unique id
    
    Since:
    
    12536
  - cloneFrom
```
public void cloneFrom(AbstractPrimitive other)
```
    Get and write all attributes from the parameter. Does not fire any listener, so use this only in the data initializing phase
    
    Parameters:
    
    other - the primitive to clone data from
  - getVersion
```
public int getVersion()
```
    Description copied from interface: IPrimitive
    
    Replies the version number as returned by the API. The version is 0 if the id is 0 or if this primitive is incomplete.
    
    Specified by:
    
    getVersion in interface IPrimitive
    
    Returns:
    
    the version number as returned by the API
    
    See Also:
    
    PrimitiveData.setVersion(int)
  - getId
```
public long getId()
```
    Description copied from interface: IPrimitive
    
    Replies the id of this primitive.
    
    Specified by:
    
    getId in interface IPrimitive
    
    Returns:
    
    the id of this primitive.
  - getUniqueId
```
public long getUniqueId()
```
    Gets a unique id representing this object.
    
    Specified by:
    
    getUniqueId in interface PrimitiveId
    
    Returns:
    
    Osm id if primitive already exists on the server. Unique negative value if primitive is new
  - isNew
```
public boolean isNew()
```
    Determines if this primitive is new.
    
    Specified by:
    
    isNew in interface PrimitiveId
    
    Returns:
    
    true if this primitive is new (not yet uploaded the server, id <= 0)
  - isNewOrUndeleted
```
public boolean isNewOrUndeleted()
```
    Description copied from interface: IPrimitive
    
    Determines if this primitive is new or undeleted.
    
    Specified by:
    
    isNewOrUndeleted in interface IPrimitive
    
    Returns:
    
    True if primitive is new or undeleted
    
    See Also:
    
    PrimitiveId.isNew(), IPrimitive.isUndeleted()
  - setOsmId
```
public void setOsmId(long id,
                     int version)
```
    Description copied from interface: IPrimitive
    
    Sets the id and the version of this primitive if it is known to the OSM API. Since we know the id and its version it can't be incomplete anymore. incomplete is set to false.
    
    Specified by:
    
    setOsmId in interface IPrimitive
    
    Parameters:
    
    id - the id. > 0 required
    
    version - the version > 0 required
  - clearOsmMetadata
```
public void clearOsmMetadata()
```
    Clears the metadata, including id and version known to the OSM API. The id is a new unique id. The version, changeset and timestamp are set to 0. incomplete and deleted are set to false. It's preferred to use copy constructor with clearMetadata set to true instead of calling this method.
    
    Since:
    
    6140
  - getUser
```
public User getUser()
```
    Description copied from interface: IPrimitive
    
    Replies the user who has last touched this object. May be null.
    
    Specified by:
    
    getUser in interface IPrimitive
    
    Returns:
    
    the user who has last touched this object. May be null.
  - setUser
```
public void setUser(User user)
```
    Description copied from interface: IPrimitive
    
    Sets the user who has last touched this object.
    
    Specified by:
    
    setUser in interface IPrimitive
    
    Parameters:
    
    user - the user
  - getChangesetId
```
public int getChangesetId()
```
    Description copied from interface: IPrimitive
    
    Replies the id of the changeset this primitive was last uploaded to. 0 if this primitive wasn't uploaded to a changeset yet or if the changeset isn't known.
    
    Specified by:
    
    getChangesetId in interface IPrimitive
    
    Returns:
    
    the id of the changeset this primitive was last uploaded to.
  - setChangesetId
```
public void setChangesetId(int changesetId)
```
    Description copied from interface: IPrimitive
    
    Sets the changeset id of this primitive. Can't be set on a new primitive.
    
    Specified by:
    
    setChangesetId in interface IPrimitive
    
    Parameters:
    
    changesetId - the id. >= 0 required.
  - setTimestamp
```
public void setTimestamp(java.util.Date timestamp)
```
    Description copied from interface: IPrimitive
    
    Sets time of last modification to this object
    
    Specified by:
    
    setTimestamp in interface IPrimitive
    
    Parameters:
    
    timestamp - date of last modification
    
    See Also:
    
    IPrimitive.getTimestamp()
  - setRawTimestamp
```
public void setRawTimestamp(int timestamp)
```
    Description copied from interface: IPrimitive
    
    Sets time of last modification to this object
    
    Specified by:
    
    setRawTimestamp in interface IPrimitive
    
    Parameters:
    
    timestamp - date of last modification
    
    See Also:
    
    IPrimitive.getRawTimestamp()
  - getTimestamp
```
public java.util.Date getTimestamp()
```
    Description copied from interface: IPrimitive
    
    Time of last modification to this object. This is not set by JOSM but read from the server and delivered back to the server unmodified. It is used to check against edit conflicts.
    
    Specified by:
    
    getTimestamp in interface IPrimitive
    
    Returns:
    
    date of last modification
    
    See Also:
    
    IPrimitive.setTimestamp(java.util.Date)
  - getRawTimestamp
```
public int getRawTimestamp()
```
    Description copied from interface: IPrimitive
    
    Time of last modification to this object. This is not set by JOSM but read from the server and delivered back to the server unmodified. It is used to check against edit conflicts.
    
    Specified by:
    
    getRawTimestamp in interface IPrimitive
    
    Returns:
    
    last modification as timestamp
    
    See Also:
    
    IPrimitive.setRawTimestamp(int)
  - isTimestampEmpty
```
public boolean isTimestampEmpty()
```
    Description copied from interface: IPrimitive
    
    Determines if this primitive has no timestamp information.
    
    Specified by:
    
    isTimestampEmpty in interface IPrimitive
    
    Returns:
    
    true if this primitive has no timestamp information
    
    See Also:
    
    IPrimitive.getTimestamp(), IPrimitive.getRawTimestamp()
  - updateFlags
```
protected void updateFlags(short flag,
                           boolean value)
```
  - setModified
```
public void setModified(boolean modified)
```
    Description copied from interface: IPrimitive
    
    Marks this primitive as being modified.
    
    Specified by:
    
    setModified in interface IPrimitive
    
    Parameters:
    
    modified - true, if this primitive is to be modified
  - isModified
```
public boolean isModified()
```
    Description copied from interface: IPrimitive
    
    Replies true if the object has been modified since it was loaded from the server. In this case, on next upload, this object will be updated. Deleted objects are deleted from the server. If the objects are added (id=0), the modified is ignored and the object is added to the server.
    
    Specified by:
    
    isModified in interface IPrimitive
    
    Returns:
    
    true if the object has been modified since it was loaded from the server
  - isDeleted
```
public boolean isDeleted()
```
    Description copied from interface: IPrimitive
    
    Replies true, if the object has been deleted.
    
    Specified by:
    
    isDeleted in interface IPrimitive
    
    Returns:
    
    true, if the object has been deleted.
    
    See Also:
    
    IPrimitive.setDeleted(boolean)
  - isUndeleted
```
public boolean isUndeleted()
```
    Description copied from interface: IPrimitive
    
    Replies true if the object has been deleted on the server and was undeleted by the user.
    
    Specified by:
    
    isUndeleted in interface IPrimitive
    
    Returns:
    
    true if the object has been undeleted
  - isUsable
```
public boolean isUsable()
```
    Description copied from interface: IPrimitive
    
    Replies true, if the object is usable (i.e. complete and not deleted).
    
    Specified by:
    
    isUsable in interface IPrimitive
    
    Returns:
    
    true, if the object is usable.
    
    See Also:
    
    IPrimitive.setDeleted(boolean)
  - isVisible
```
public boolean isVisible()
```
    Description copied from interface: IPrimitive
    
    Checks if object is known to the server. Replies true if this primitive is either unknown to the server (i.e. its id is 0) or it is known to the server and it hasn't be deleted on the server. Replies false, if this primitive is known on the server and has been deleted on the server.
    
    Specified by:
    
    isVisible in interface IPrimitive
    
    Returns:
    
    true, if the object is visible on server.
    
    See Also:
    
    IPrimitive.setVisible(boolean)
  - setVisible
```
public void setVisible(boolean visible)
```
    Description copied from interface: IPrimitive
    
    Sets whether this primitive is visible, i.e. whether it is known on the server and not deleted on the server.
    
    Specified by:
    
    setVisible in interface IPrimitive
    
    Parameters:
    
    visible - true if this primitive is visible
    
    See Also:
    
    IPrimitive.isVisible()
  - 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
    
    Parameters:
    
    deleted - true, if this primitive is deleted; false, otherwise
  - setIncomplete
```
protected void setIncomplete(boolean incomplete)
```
    If set to true, this object is incomplete, which means only the id and type is known (type is the objects instance class)
    
    Parameters:
    
    incomplete - incomplete flag value
  - isIncomplete
```
public boolean isIncomplete()
```
    Description copied from interface: IPrimitive
    
    Determines if this primitive is incomplete.
    
    Specified by:
    
    isIncomplete in interface IPrimitive
    
    Returns:
    
    true if this primitive is incomplete, false otherwise
  - getFlagsAsString
```
protected java.lang.String getFlagsAsString()
```
  - getKeys
```
public TagMap getKeys()
```
    Replies the map of key/value pairs. Never replies null. The map can be empty, though.
    
    Specified by:
    
    getKeys in interface Tagged
    
    Returns:
    
    tags of this primitive. Changes made in returned map are not mapped back to the primitive, use setKeys() to modify the keys
    
    See Also:
    
    visitKeys(KeyValueVisitor)
  - visitKeys
```
public void visitKeys(KeyValueVisitor visitor)
```
    Description copied from interface: Tagged
    
    Calls the visitor for every key/value pair.
    
    Specified by:
    
    visitKeys in interface Tagged
    
    Parameters:
    
    visitor - The visitor to call.
    
    See Also:
    
    Tagged.getKeys()
  - setKeys
```
public void setKeys(java.util.Map<java.lang.String,java.lang.String> keys)
```
    Sets the keys of this primitives to the key/value pairs in keys. Old key/value pairs are removed. If keys is null, clears existing key/value pairs.
    Note that this method, like all methods that modify keys, is not synchronized and may lead to data corruption when being used from multiple threads.
    
    Specified by:
    
    setKeys in interface Tagged
    
    Parameters:
    
    keys - the key/value pairs to set. If null, removes all existing key/value pairs.
  - setKeys
```
public void setKeys(TagMap keys)
```
    Copy the keys from a TagMap.
    
    Parameters:
    
    keys - The new key map.
  - put
```
public void put(java.lang.String key,
                java.lang.String value)
```
    Set the given value to the given key. If key is null, does nothing. If value is null, removes the key and behaves like remove(String).
    Note that this method, like all methods that modify keys, is not synchronized and may lead to data corruption when being used from multiple threads.
    
    Specified by:
    
    put in interface Tagged
    
    Parameters:
    
    key - The key, for which the value is to be set. Can be null or empty, does nothing in this case.
    
    value - The value for the key. If null, removes the respective key/value pair.
    
    See Also:
    
    remove(String)
  - indexOfKey
```
private static int indexOfKey(java.lang.String[] keys,
                              java.lang.String key)
```
    Scans a key/value array for a given key.
    
    Parameters:
    
    keys - The key array. It is not modified. It may be null to indicate an emtpy array.
    
    key - The key to search for.
    
    Returns:
    
    The position of that key in the keys array - which is always a multiple of 2 - or -1 if it was not found.
  - remove
```
public void remove(java.lang.String key)
```
    Remove the given key from the list
    Note that this method, like all methods that modify keys, is not synchronized and may lead to data corruption when being used from multiple threads.
    
    Specified by:
    
    remove in interface Tagged
    
    Parameters:
    
    key - the key to be removed. Ignored, if key is null.
  - removeAll
```
public void removeAll()
```
    Removes all keys from this primitive.
    Note that this method, like all methods that modify keys, is not synchronized and may lead to data corruption when being used from multiple threads.
    
    Specified by:
    
    removeAll in interface Tagged
  - doGet
```
protected final java.lang.String doGet(java.lang.String key,
                                       java.util.function.BiPredicate<java.lang.String,java.lang.String> predicate)
```
  - get
```
public final java.lang.String get(java.lang.String key)
```
    Replies the value for key key. Replies null, if key is null. Replies null, if there is no value for the given key.
    
    Specified by:
    
    get in interface Tagged
    
    Parameters:
    
    key - the key. Can be null, replies null in this case.
    
    Returns:
    
    the value for key key.
  - getIgnoreCase
```
public final java.lang.String getIgnoreCase(java.lang.String key)
```
    Gets a key ignoring the case of the key
    
    Parameters:
    
    key - The key to get
    
    Returns:
    
    The value for a key that matches the given key ignoring case.
  - getNumKeys
```
public final 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.
  - 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
  - hasKeys
```
public final boolean hasKeys()
```
    Replies true, if the map of key/value pairs of this primitive is not empty.
    
    Specified by:
    
    hasKeys in interface Tagged
    
    Returns:
    
    true, if the map of key/value pairs of this primitive is not empty; false otherwise
  - hasKey
```
public boolean hasKey(java.lang.String key)
```
    Replies true if this primitive has a tag with key key.
    
    Specified by:
    
    hasKey in interface Tagged
    
    Parameters:
    
    key - the key
    
    Returns:
    
    true, if this primitive has a tag with key key
    
    See Also:
    
    Tagged.hasTag(String)
  - hasKey
```
public boolean hasKey(java.lang.String... keys)
```
    Replies true if this primitive has a tag any of the keys.
    
    Parameters:
    
    keys - the keys
    
    Returns:
    
    true, if this primitive has a tag with any of the keys
    
    Since:
    
    11587
  - keysChangedImpl
```
protected abstract 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.
    
    Parameters:
    
    originalKeys - original tags
  - getUninterestingKeys
```
public static java.util.Collection<java.lang.String> getUninterestingKeys()
```
    Returns a list of "uninteresting" keys that do not make an object "tagged". Entries that end with ':' are causing a whole namespace to be considered "uninteresting". Only the first level namespace is considered. Initialized by isUninterestingKey()
    
    Returns:
    
    The list of uninteresting keys.
  - getDiscardableKeys
```
public static java.util.Collection<java.lang.String> getDiscardableKeys()
```
    Returns a list of keys which have been deemed uninteresting to the point that they can be silently removed from data which is being edited.
    
    Returns:
    
    The list of discardable keys.
  - getWorkInProgressKeys
```
public static java.util.Collection<java.lang.String> getWorkInProgressKeys()
```
    Returns a list of "work in progress" keys that do not make an object "tagged" but "annotated".
    
    Returns:
    
    The list of work in progress keys.
    
    Since:
    
    5754
  - isUninterestingKey
```
public static boolean isUninterestingKey(java.lang.String key)
```
    Determines if key is considered "uninteresting".
    
    Parameters:
    
    key - The key to check
    
    Returns:
    
    true if key is considered "uninteresting".
  - getInterestingTags
```
public java.util.Map<java.lang.String,java.lang.String> getInterestingTags()
```
    Description copied from interface: IPrimitive
    
    Returns Tagged.getKeys() for which key does not fulfill uninteresting criteria.
    
    Specified by:
    
    getInterestingTags in interface IPrimitive
    
    Returns:
    
    A map of interesting tags

Class AbstractPrimitive

Field Summary

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

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

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

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

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

Methods inherited from interface java.lang.Comparable

Field Detail

idCounter

FLAG_MODIFIED

FLAG_VISIBLE

FLAG_DELETED

FLAG_INCOMPLETE

FLAG_DISABLED

FLAG_HIDE_IF_DISABLED

FLAG_DISABLED_TYPE

FLAG_HIDDEN_TYPE

FLAG_HAS_DIRECTIONS

FLAG_TAGGED

FLAG_DIRECTION_REVERSED

FLAG_HIGHLIGHTED

FLAG_ANNOTATED

FLAG_PRESERVED

flags

id

user

version

changesetId

timestamp

keys

workinprogress

uninteresting

discardable

Constructor Detail

AbstractPrimitive

Method Detail

generateUniqueId

currentUniqueId

advanceUniqueId

cloneFrom

getVersion

getId

getUniqueId

isNew

isNewOrUndeleted

setOsmId

clearOsmMetadata

getUser

setUser

getChangesetId

setChangesetId

setTimestamp

setRawTimestamp

getTimestamp

getRawTimestamp

isTimestampEmpty

updateFlags

setModified

isModified

isDeleted

isUndeleted

isUsable

isVisible

setVisible

setDeleted

setIncomplete

isIncomplete

getFlagsAsString

getKeys

visitKeys

setKeys

setKeys

put

indexOfKey

remove

removeAll