This abstract class represents a structure of structure elements or other objects.
Heirs of this abstract class must decide how object should be stored and how they should be read
from a structure. Possible heirs could be XMLStructure.
Subclasses should call the
ExternalStructure.fireStructureChange(StructureChangeEvent) method whenever the content or the state of the structure changes. This method notifies all
StructureChangeListeners added to this object of the structure change.
Adds a structure change listener to the list of structure change listeners. All listeners
will be notified when this structure changes.
Parameters: listener - the listener to add
Fires a structure change (content or state) to all structure change listeners.
Parameters: event - the event wich contains the information of the change
Returns the record of the extrnal structure. If there is no converter registered for a sort
of xml elements, they will not be in the structure.
record of the extrnal structure throws: StructureException - if the structure is not open
Returns the root element of the structure. If there is no converter registered for a sort of
xml elements, they will not be in the structure.
root element of the structure throws: StructureException - if the structure is not open
Returns whether this structure has at least one element or not. Should throw a
StructureException if the structure is not open, for example.
true if this structure is empty, otherwise false throws: StructureException - if an error has occurred
Makes this structure get ready for storing. Should throw a
StructureException if the
structure is already open, for example.
throws: StructureException - if an error has occurred
Sets the record of the recordables. Should throw a
StructureException if the
structure is not open, for example.
Parameters: record - the structure element to be stored throws: StructureException - if an error has occurred
Set the root element of the structure. The root element and all its children will be saved
in the extranaö structure. Should throw a
StructureException if the structure is
not open, for example.
Parameters: root - the root element of the structure that should be saved. throws: StructureException - if an error has occurred