org.geotools.data
Class FeatureListenerManager

java.lang.Object
  org.geotools.data.FeatureListenerManager

public class FeatureListenerManager

extends java.lang.Object

This class is used by DataStore implementations to provide FeatureListener support for the FeatureSources they create.

FeatureWriters created by the DataStore will need to make use of this class to provide the required FeatureEvents.

Author:

Jody Garnett, Refractions Research

Constructor Summary

FeatureListenerManager()

Method Summary

void	addFeatureListener(FeatureSource featureSource, FeatureListener featureListener) Used by FeaureSource implementations to provide listener support.
javax.swing.event.EventListenerList	eventListenerList(FeatureSource featureSource)
void	fireChanged(java.lang.String typeName, Transaction transaction, boolean commit) Notify all listeners that have registered interest for notification on this event type.
void	fireFeaturesAdded(java.lang.String typeName, Transaction transaction, com.vividsolutions.jts.geom.Envelope bounds) Notify all listeners that have registered interest for notification on this event type.
void	fireFeaturesChanged(java.lang.String typeName, Transaction transaction, com.vividsolutions.jts.geom.Envelope bounds) Notify all listeners that have registered interest for notification on this event type.
void	fireFeaturesRemoved(java.lang.String typeName, Transaction transaction, com.vividsolutions.jts.geom.Envelope bounds) Notify all listeners that have registered interest for notification on this event type.
void	removeFeatureListener(FeatureSource featureSource, FeatureListener featureListener) Used by FeatureSource implementations to provide listener support.

Methods inherited from class java.lang.Object

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

Constructor Detail

FeatureListenerManager

public FeatureListenerManager()

Method Detail

addFeatureListener

public void addFeatureListener(FeatureSource featureSource,
                               FeatureListener featureListener)

Used by FeaureSource implementations to provide listener support.

Parameters:

featureSource -

featureListener -

removeFeatureListener

public void removeFeatureListener(FeatureSource featureSource,
                                  FeatureListener featureListener)

Used by FeatureSource implementations to provide listener support.

Parameters:

featureSource -

featureListener -

eventListenerList

public javax.swing.event.EventListenerList eventListenerList(FeatureSource featureSource)

fireFeaturesAdded

public void fireFeaturesAdded(java.lang.String typeName,
                              Transaction transaction,
                              com.vividsolutions.jts.geom.Envelope bounds)

Notify all listeners that have registered interest for notification on this event type.

This method is called by:

• FeatureWriter.next() with FeatureWriter.hasNext() == false
  - when an existing Feature is removed with Tranasaction.AUTO_COMMIT all listeners registered with FeatureSource of typeName will be notified.
• FeatureWriter.next()with FeatureWriter.hasNext() == false
  - when an existing Feature is removed with a Transaction all listeners registered with FeatureSource of typeName and with the same Transaction will be notified.

Parameters:

typeName - typeName being modified

transaction - Transaction used for change

bounds - BoundingBox of changes (may be null if unknown)

fireFeaturesChanged

public void fireFeaturesChanged(java.lang.String typeName,
                                Transaction transaction,
                                com.vividsolutions.jts.geom.Envelope bounds)

Notify all listeners that have registered interest for notification on this event type.

This method is called by:

• FeatureWriter.next() with FeatureWriter.hasNext() == true
  - when an existing Feature is modified with Tranasaction.AUTO_COMMIT all listeners registered with FeatureSource of typeName will be notified.
• FeatureWriter.next()with FeatureWriter.hasNext() == true
  - when an existing Feature is modified, with a Transaction all listeners registered with FeatureSource of typeName and with the same Transaction will be notified.

Parameters:

typeName - typeName being modified

transaction - Transaction used for change

bounds - BoundingBox of changes (may be null if unknown)

fireChanged

public void fireChanged(java.lang.String typeName,
                        Transaction transaction,
                        boolean commit)

Notify all listeners that have registered interest for notification on this event type.

This method is called by:

• Transaction.commit()
  - when changes have occured on a Transaction all listeners registered with FeatureSource of typeName will be notified except those with the Same Transaction
• Transaction.rollback()
  - when changes have been reverted only those listeners registered with FeatureSource of typeName and with the same Transaction will be notified.

Parameters:

typeName - typeName being modified

transaction - Transaction used for change

commit - true for commit, false for rollback

fireFeaturesRemoved

public void fireFeaturesRemoved(java.lang.String typeName,
                                Transaction transaction,
                                com.vividsolutions.jts.geom.Envelope bounds)

Notify all listeners that have registered interest for notification on this event type.

This method is called by:

• FeatureWrtier.remove() - when an existing Feature is removed with Tranasaction.AUTO_COMMIT all listeners registered with FeatureSource of typeName will be notified.
• FeatureWrtier.remove() - when an existing Feature is removed with a Transaction all listeners registered with FeatureSource of typeName and with the same Transaction will be notified.

Parameters:

typeName - typeName being modified

transaction - Transaction used for change

bounds - BoundingBox of changes (may be null if unknown)