Package VASSAL.property

Class ConcurrentPropertySupport

java.lang.Object

VASSAL.property.ConcurrentPropertySupport

All Implemented Interfaces:

PropertySupport

public class ConcurrentPropertySupport
extends Object
implements PropertySupport

A thread-safe implementation of PropertySupport.

Since:

3.2.0

Author:

Joel Uckelman

Field Summary

Fields

Modifier and Type	Field	Description
protected CopyOnWriteArrayList<PropertyListener<Object>>	listeners
protected ConcurrentMap<Property<?>,List<PropertyListener<?>>>	plisteners

Constructor Summary

Constructors

Constructor	Description
ConcurrentPropertySupport()

Method Summary

Modifier and Type	Method	Description
<T> void	addPropertyListener(Property<T> prop, PropertyListener<? super T> l)	Adds a listener for a specific Property.
void	addPropertyListener(PropertyListener<Object> l)	Adds a listener for all changes.
<T> void	fireChanged(Object src, Property<T> prop, T oldVal, T newVal)	Notifies listeners of a property change.
List<PropertyListener<Object>>	getPropertyListeners()	Returns a list of PropertyListeners listening to all changes.
<T> List<PropertyListener<? super T>>	getPropertyListeners(Property<T> prop)	Returns a list of PropertyListeners listening to a given Property.
boolean	hasListeners()	Checks whether there are PropertyListeners for all changes.
<T> boolean	hasListeners(Property<T> prop)	Checks whether there are PropertyListeners for a given Property.
<T> void	removePropertyListener(Property<T> prop, PropertyListener<? super T> l)	Removes a listener for a specific Property.
void	removePropertyListener(PropertyListener<Object> l)	Removes a listner for all changes.

Methods inherited from class java.lang.Object

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

Field Details

listeners

protected final CopyOnWriteArrayList<PropertyListener<Object>> listeners

plisteners

protected final ConcurrentMap<Property<?>,List<PropertyListener<?>>> plisteners

Constructor Details

ConcurrentPropertySupport

public ConcurrentPropertySupport()

Method Details

addPropertyListener

public void addPropertyListener(PropertyListener<Object> l)

Adds a listener for all changes.

Specified by:

addPropertyListener in interface PropertySupport

Parameters:

l - the listener to add

Throws:

IllegalArgumentException - if l is null

removePropertyListener

public void removePropertyListener(PropertyListener<Object> l)

Removes a listner for all changes.

Specified by:

removePropertyListener in interface PropertySupport

Parameters:

l - the listener to remove

Throws:

IllegalArgumentException - if l is null

hasListeners

public boolean hasListeners()

Checks whether there are PropertyListeners for all changes.

Specified by:

hasListeners in interface PropertySupport

Returns:

true if there are listeners

getPropertyListeners

public List<PropertyListener<Object>> getPropertyListeners()

Returns a list of PropertyListeners listening to all changes.

Specified by:

getPropertyListeners in interface PropertySupport

Returns:

a list of listeners

addPropertyListener

public <T> void addPropertyListener(Property<T> prop,
PropertyListener<? super T> l)

Adds a listener for a specific Property.

Specified by:

addPropertyListener in interface PropertySupport

Parameters:

prop - the Property to listen on

l - the listener to add

removePropertyListener

public <T> void removePropertyListener(Property<T> prop,
PropertyListener<? super T> l)

Removes a listener for a specific Property.

Specified by:

removePropertyListener in interface PropertySupport

Parameters:

prop - the Property listened on

l - the listener to remove

getPropertyListeners

public <T> List<PropertyListener<? super T>> getPropertyListeners(Property<T> prop)

Returns a list of PropertyListeners listening to a given Property.

Specified by:

getPropertyListeners in interface PropertySupport

Parameters:

prop - the Property listened on

Returns:

a list of listeners

hasListeners

public <T> boolean hasListeners(Property<T> prop)

Checks whether there are PropertyListeners for a given Property.

Specified by:

hasListeners in interface PropertySupport

Returns:

true if there are listeners for the given property

fireChanged

public <T> void fireChanged(Object src,
Property<T> prop,
T oldVal,
T newVal)

Notifies listeners of a property change.

Specified by:

fireChanged in interface PropertySupport

Parameters:

src - the source of the change

prop - the changed Property

oldVal - the old value of the Property

newVal - the new value of the Property