kcl.waterloo.observable

Class GJAbstractObservable

java.lang.Object

kcl.waterloo.observable.GJAbstractObservable

All Implemented Interfaces:

java.beans.PropertyChangeListener, java.util.EventListener, GJLinkableInterface, GJObservableInterface

Direct Known Subclasses:

GJAbstractDataVector, GJAbstractPlotModelImpl, GJDataModel

public abstract class GJAbstractObservable
extends java.lang.Object
implements GJObservableInterface, GJLinkableInterface

/** Abstract implementation of the GJObservableInterface. Listeners can be added using the addPropertyChangeListener methods and are registered in a PropertyChangeSupport instance stored as a property of the GJAbstractObservable superclass instance. A list of linked objects is maintained in an internal ArrayList. Objects in the list can be modified in propertyChange methods of super-classes that extend the GJAbstractObservable class.

Constructor Summary

Constructors

Constructor and Description
GJAbstractObservable()

Method Summary

Modifier and Type	Method and Description
void	addLink(java.lang.Object o) Adds an Object to the Links map
void	addPropertyChangeListener(java.beans.PropertyChangeListener listener) Adds a property change listener.
void	addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener) See java.beans.PropertyChangeSupport
void	firePropertyChange(java.beans.PropertyChangeEvent pce)
java.util.ArrayList<java.lang.Object>	getLinks() Returns the list of linked Objects
java.beans.PropertyChangeSupport	getPCS()
java.beans.PropertyChangeListener[]	getPropertyChangeListeners() See java.beans.PropertyChangeSupport
java.beans.PropertyChangeListener[]	getPropertyChangeListeners(java.lang.String propertyName) See java.beans.PropertyChangeSupport
boolean	hasListeners(java.lang.String propertyName) Returns true if this instance has installed listeners.
boolean	hasSelfListener() Returns true if the implementing instance is a listener.
void	removeLink(java.lang.Object o) Removes an Object from the Links map
void	removePropertyChangeListener(java.beans.PropertyChangeListener listener) See java.beans.PropertyChangeSupport
void	removePropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener) See java.beans.PropertyChangeSupport
void	setLinks(java.util.ArrayList<java.lang.Object> Links) Sets the list of linked objects

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.beans.PropertyChangeListener

propertyChange

Constructor Detail

GJAbstractObservable

public GJAbstractObservable()

Method Detail

addLink

public void addLink(java.lang.Object o)

Description copied from interface: GJLinkableInterface

Adds an Object to the Links map

Specified by:

addLink in interface GJLinkableInterface

Parameters:

o -

removeLink

public void removeLink(java.lang.Object o)

Removes an Object from the Links map

Specified by:

removeLink in interface GJLinkableInterface

getLinks

public java.util.ArrayList<java.lang.Object> getLinks()

Returns the list of linked Objects

Specified by:

getLinks in interface GJLinkableInterface

Returns:

the ArrayList of linked Objects

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)

Adds a property change listener. Note that addPropertyChangeListener might be called from a super-constructor with some L&Fs so addPropertyChangeListener should test for null PropertyChangeSupport and initialize it if needed.

Specified by:

addPropertyChangeListener in interface GJObservableInterface

Parameters:

listener - - the object that listens.

addPropertyChangeListener

public void addPropertyChangeListener(java.lang.String propertyName,
                                      java.beans.PropertyChangeListener listener)

See java.beans.PropertyChangeSupport

Specified by:

addPropertyChangeListener in interface GJObservableInterface

getPropertyChangeListeners

public java.beans.PropertyChangeListener[] getPropertyChangeListeners()

See java.beans.PropertyChangeSupport

Specified by:

getPropertyChangeListeners in interface GJObservableInterface

Returns:

a PropertyChangeListener[]

getPropertyChangeListeners

public java.beans.PropertyChangeListener[] getPropertyChangeListeners(java.lang.String propertyName)

See java.beans.PropertyChangeSupport

Specified by:

getPropertyChangeListeners in interface GJObservableInterface

Returns:

a PropertyChangeListener[]

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)

See java.beans.PropertyChangeSupport

Specified by:

removePropertyChangeListener in interface GJObservableInterface

removePropertyChangeListener

public void removePropertyChangeListener(java.lang.String propertyName,
                                         java.beans.PropertyChangeListener listener)

See java.beans.PropertyChangeSupport

Specified by:

removePropertyChangeListener in interface GJObservableInterface

hasListeners

public boolean hasListeners(java.lang.String propertyName)

Returns true if this instance has installed listeners. See java.beans.PropertyChangeSupport

Specified by:

hasListeners in interface GJObservableInterface

Returns:

the flag

getPCS

public final java.beans.PropertyChangeSupport getPCS()

Returns:

the pcs

setLinks

public void setLinks(java.util.ArrayList<java.lang.Object> Links)

Description copied from interface: GJLinkableInterface

Sets the list of linked objects

Specified by:

setLinks in interface GJLinkableInterface

Parameters:

Links -

hasSelfListener

public boolean hasSelfListener()

Description copied from interface: GJObservableInterface

Returns true if the implementing instance is a listener.

Specified by:

hasSelfListener in interface GJObservableInterface

Returns:

true/false

firePropertyChange

public void firePropertyChange(java.beans.PropertyChangeEvent pce)

Specified by:

firePropertyChange in interface GJObservableInterface