org.openstreetmap.josm.data.osm.history

Class History

java.lang.Object

org.openstreetmap.josm.data.osm.history.History

public class History
extends Object

Represents the history of an OSM primitive. The history consists of a list of object snapshots with a specific version.

Since:

1670

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static interface	History.FilterPredicate

Field Summary

Fields

Modifier and Type	Field and Description
private long	id the object id
private OsmPrimitiveType	type the object type
private List<HistoryOsmPrimitive>	versions the list of object snapshots

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	History(long id, OsmPrimitiveType type, List<HistoryOsmPrimitive> versions) Creates a new history for an OSM primitive.

Method Summary

Modifier and Type	Method and Description
History	between(Date fromDate, Date untilDate) Returns a new partial copy of this history, between the given dates
History	between(long fromVersion, long untilVersion) Returns a new partial copy of this history, betwwen the given version numbers
boolean	contains(long version) Determines if this history contains a specific version number.
private static History	filter(History history, History.FilterPredicate predicate)
History	forUserId(long uid) Returns a new partial copy of this history, for the given user id
History	from(Date fromDate) Returns a new partial copy of this history, from the given date
History	from(long fromVersion) Returns a new partial copy of this history, from the given version number
HistoryOsmPrimitive	get(int idx) Replies the history primitive at index idx.
HistoryOsmPrimitive	getByDate(Date date) Replies the history primitive at given date.
HistoryOsmPrimitive	getByVersion(long version) Replies the history primitive with version version.
HistoryOsmPrimitive	getEarliest() Replies the earliest entry of this history.
long	getId() Replies the primitive id for this history.
HistoryOsmPrimitive	getLatest() Replies the latest entry of this history.
int	getNumVersions() Replies the number of versions.
PrimitiveId	getPrimitiveId() Replies the primitive id for this history.
OsmPrimitiveType	getType() Replies the primitive type for this history.
boolean	isEmpty() Returns true if this history contains no version.
History	sortAscending() Returns a new copy of this history, sorted in ascending order.
History	sortDescending() Returns a new copy of this history, sorted in descending order.
String	toString()
History	until(Date untilDate) Returns a new partial copy of this history, until the given date
History	until(long untilVersion) Returns a new partial copy of this history, to the given version number

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

versions

private final List<HistoryOsmPrimitive> versions

the list of object snapshots

id

private final long id

the object id

type

private final OsmPrimitiveType type

the object type

Constructor Detail

History

protected History(long id,
                  OsmPrimitiveType type,
                  List<HistoryOsmPrimitive> versions)

Creates a new history for an OSM primitive.

Parameters:

id - the id. > 0 required.

type - the primitive type. Must not be null.

versions - a list of versions. Can be null.

Throws:

IllegalArgumentException - if id <= 0

IllegalArgumentException - if type is null

Method Detail

filter

private static History filter(History history,
                              History.FilterPredicate predicate)

sortAscending

public History sortAscending()

Returns a new copy of this history, sorted in ascending order.

Returns:

a new copy of this history, sorted in ascending order

sortDescending

public History sortDescending()

Returns a new copy of this history, sorted in descending order.

Returns:

a new copy of this history, sorted in descending order

from

public History from(Date fromDate)

Returns a new partial copy of this history, from the given date

Parameters:

fromDate - the starting date

Returns:

a new partial copy of this history, from the given date

until

public History until(Date untilDate)

Returns a new partial copy of this history, until the given date

Parameters:

untilDate - the end date

Returns:

a new partial copy of this history, until the given date

between

public History between(Date fromDate,
                       Date untilDate)

Returns a new partial copy of this history, between the given dates

Parameters:

fromDate - the starting date

untilDate - the end date

Returns:

a new partial copy of this history, between the given dates

from

public History from(long fromVersion)

Returns a new partial copy of this history, from the given version number

Parameters:

fromVersion - the starting version number

Returns:

a new partial copy of this history, from the given version number

until

public History until(long untilVersion)

Returns a new partial copy of this history, to the given version number

Parameters:

untilVersion - the ending version number

Returns:

a new partial copy of this history, to the given version number

between

public History between(long fromVersion,
                       long untilVersion)

Returns a new partial copy of this history, betwwen the given version numbers

Parameters:

fromVersion - the starting version number

untilVersion - the ending version number

Returns:

a new partial copy of this history, between the given version numbers

forUserId

public History forUserId(long uid)

Returns a new partial copy of this history, for the given user id

Parameters:

uid - the user id

Returns:

a new partial copy of this history, for the given user id

getId

public long getId()

Replies the primitive id for this history.

Returns:

the primitive id

See Also:

getPrimitiveId(), getType()

getPrimitiveId

public PrimitiveId getPrimitiveId()

Replies the primitive id for this history.

Returns:

the primitive id

See Also:

getId()

contains

public boolean contains(long version)

Determines if this history contains a specific version number.

Parameters:

version - the version number to look for

Returns:

true if this history contains version, false otherwise

getByVersion

public HistoryOsmPrimitive getByVersion(long version)

Replies the history primitive with version version. null, if no such primitive exists.

Parameters:

version - the version

Returns:

the history primitive with version version

getByDate

public HistoryOsmPrimitive getByDate(Date date)

Replies the history primitive at given date. null, if no such primitive exists.

Parameters:

date - the date

Returns:

the history primitive at given date

get

public HistoryOsmPrimitive get(int idx)
                        throws IndexOutOfBoundsException

Replies the history primitive at index idx.

Parameters:

idx - the index

Returns:

the history primitive at index idx

Throws:

IndexOutOfBoundsException - if index out or range

getEarliest

public HistoryOsmPrimitive getEarliest()

Replies the earliest entry of this history.

Returns:

the earliest entry of this history

getLatest

public HistoryOsmPrimitive getLatest()

Replies the latest entry of this history.

Returns:

the latest entry of this history

getNumVersions

public int getNumVersions()

Replies the number of versions.

Returns:

the number of versions

isEmpty

public final boolean isEmpty()

Returns true if this history contains no version.

Returns:

true if this history contains no version, false otherwise

getType

public OsmPrimitiveType getType()

Replies the primitive type for this history.

Returns:

the primitive type

See Also:

getId()

toString

public String toString()

Overrides:

toString in class Object