fr.gael.drb
Interface DrbNodesChangeListener

All Superinterfaces:

EventListener

All Known Implementing Classes:

DrbAbstractNode, DrbDefaultMutableNode, DrbDefaultNodesChangeProducer, DrbNodeImpl, fr.gael.drb.impl.spi.DrbNodeSpi, File, FileNode, FtpNode, URLNode, XmlDocument, XmlNode, XsdNodeImpl, ZipFileNode, ZipNode

public interface DrbNodesChangeListener
extends EventListener

Interface for listening DRB node changes. It is useful to monitor the changes of a node. For instance, a node may change when any sibling, child has been set or when a feature of node has been modified (e.g. its name). This interface unifies the way the event are fired from the nodes to the any monitoring object. It is important to keep in mind that NOT ALL the DrbNodes are able to handle change events. The use of this interface is similar to the listener of most of the Java API and in particular the TreeModelListener.

Method Summary

void	nodesChanged(DrbNodesChangeEvent event) Invoked after a node (or a set of siblings) has changed.
void	nodesInserted(DrbNodesChangeEvent event) Invoked after nodes have been inserted.
void	nodesRemoved(DrbNodesChangeEvent event) Invoked after nodes have been removed.
void	structureChanged(DrbNodesChangeEvent event) Invoked when the DRB tree structure has been drastically changed.

Method Detail

nodesChanged

void nodesChanged(DrbNodesChangeEvent event)

Invoked after a node (or a set of siblings) has changed. The node(s) have not changed locations in the tree or altered their children, but other attributes have changed and may affect presentation. Example: the name of a wrapped file has changed, but it is in the same location in the file system.

Parameters:

event - The event that references the changes.

nodesInserted

void nodesInserted(DrbNodesChangeEvent event)

Invoked after nodes have been inserted. Only inserted elements are referenced in the passed event. The parent of the inserted nodes can be the source of event when only one parent is affected by the change. Otherwise the parent can be retreived throught the DrbNode API of the inserted nodes.

Parameters:

event - The event that references the changes.

nodesRemoved

void nodesRemoved(DrbNodesChangeEvent event)

Invoked after nodes have been removed. This opertation is invoked only onces when a subtree has been removed and not for each node belonging to this subtree. The event references the removed nodes. A special attention shall be paid to these references that may have a important memory footprint.

Parameters:

event - The event that references the changes.

structureChanged

void structureChanged(DrbNodesChangeEvent event)

Invoked when the DRB tree structure has been drastically changed. The changed nodes hold by the event are the top subtree element from which a drastic change has been performed (from these nodes to there leaves).

Parameters:

event - The event that references the changes.