org.openstreetmap.josm.data.osm

Class ChangesetCache

java.lang.Object

org.openstreetmap.josm.data.osm.ChangesetCache

All Implemented Interfaces:

Preferences.PreferenceChangedListener

public final class ChangesetCache
extends Object
implements Preferences.PreferenceChangedListener

ChangesetCache is global in-memory cache for changesets downloaded from an OSM API server. The unique instance is available as singleton, see getInstance(). Clients interested in cache updates can register for ChangesetCacheEvents using addChangesetCacheListener(ChangesetCacheListener). They can use removeChangesetCacheListener(ChangesetCacheListener) to unregister as cache event listener. The cache itself listens to PreferenceChangeEvents. It clears itself if the OSM API URL is changed in the preferences. ChangesetCacheEvents are delivered on the EDT.

Field Summary

Fields

Modifier and Type	Field and Description
private Map<Integer,Changeset>	cache the cached changesets
private static ChangesetCache	instance the unique instance
private CopyOnWriteArrayList<ChangesetCacheListener>	listeners

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ChangesetCache()

Method Summary

Modifier and Type	Method and Description
void	addChangesetCacheListener(ChangesetCacheListener listener)
void	clear()
boolean	contains(Changeset cs)
boolean	contains(int id)
protected void	fireChangesetCacheEvent(ChangesetCacheEvent e)
Changeset	get(int id)
Set<Changeset>	getChangesets()
static ChangesetCache	getInstance() Replies the unique instance of the cache
List<Changeset>	getOpenChangesets() Replies the list of open changesets.
void	preferenceChanged(Preferences.PreferenceChangeEvent e) Trigerred when a preference entry value changes.
void	remove(Changeset cs)
void	remove(Collection<Changeset> changesets) Removes the changesets in changesets from the cache.
void	remove(int id)
protected void	remove(int id, DefaultChangesetCacheEvent e)
void	removeChangesetCacheListener(ChangesetCacheListener listener)
int	size()
void	update(Changeset cs)
protected void	update(Changeset cs, DefaultChangesetCacheEvent e)
void	update(Collection<Changeset> changesets)

Methods inherited from class java.lang.Object

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

Field Detail

instance

private static final ChangesetCache instance

the unique instance

cache

private final Map<Integer,Changeset> cache

the cached changesets

listeners

private final CopyOnWriteArrayList<ChangesetCacheListener> listeners

Constructor Detail

ChangesetCache

private ChangesetCache()

Method Detail

getInstance

public static ChangesetCache getInstance()

Replies the unique instance of the cache

Returns:

the unique instance of the cache

addChangesetCacheListener

public void addChangesetCacheListener(ChangesetCacheListener listener)

removeChangesetCacheListener

public void removeChangesetCacheListener(ChangesetCacheListener listener)

fireChangesetCacheEvent

protected void fireChangesetCacheEvent(ChangesetCacheEvent e)

update

protected void update(Changeset cs,
                      DefaultChangesetCacheEvent e)

update

public void update(Changeset cs)

update

public void update(Collection<Changeset> changesets)

contains

public boolean contains(int id)

contains

public boolean contains(Changeset cs)

get

public Changeset get(int id)

getChangesets

public Set<Changeset> getChangesets()

remove

protected void remove(int id,
                      DefaultChangesetCacheEvent e)

remove

public void remove(int id)

remove

public void remove(Changeset cs)

remove

public void remove(Collection<Changeset> changesets)

Removes the changesets in changesets from the cache. A ChangesetCacheEvent is fired.

Parameters:

changesets - the changesets to remove. Ignored if null.

size

public int size()

clear

public void clear()

getOpenChangesets

public List<Changeset> getOpenChangesets()

Replies the list of open changesets.

Returns:

The list of open changesets

preferenceChanged

public void preferenceChanged(Preferences.PreferenceChangeEvent e)

Description copied from interface: Preferences.PreferenceChangedListener

Trigerred when a preference entry value changes.

Specified by:

preferenceChanged in interface Preferences.PreferenceChangedListener

Parameters:

e - the preference change event