ILcdModelTreeNode (LuciadFusion API documentation)

All Superinterfaces:

AutoCloseable, EventListener, ILcdDisposable, ILcdModel, ILcdModelContainer, ILcdModelProducerListener, Serializable

All Known Implementing Classes:

TLcd2DBoundsIndexedModelTreeNode, TLcdGML2AbstractFeatureCollection, TLcdGML31AbstractFeatureCollection, TLcdGML31DynamicFeatureCollection, TLcdGML31FeatureCollection, TLcdGML31Model, TLcdGML32AbstractFeatureCollection, TLcdGML32FeatureCollection, TLcdGML32Model, TLcdKML22AbstractContainer, TLcdKML22Document, TLcdKML22DynamicModel, TLcdKML22Folder, TLcdKML22Kml, TLcdKML22NetworkLink, TLcdModelTreeNode
```
public interface ILcdModelTreeNode
extends ILcdModel, ILcdModelContainer
```
An ILcdModelTreeNode is an ILcdModel which can also have child models. This allows to create a hierarchical model structure.

This interface extends ILcdModelContainer since it is a container for its child models. Therefore, all methods inherited from ILcdModelContainer only apply on the child models. An example is modelCount() which will return the number of child models of this model node. This does not include the node itself.

It also extends ILcdModel since every model node is a model itself. Therefore, all methods inherited from ILcdModel only apply on the node, and not on its child models. For example calling addElement(Object, int) will add the element only to this model node, and not to all its child models.

The difference with a TLcdModelList is that the model list is a composite model where an ILcdModelTreeNode is a model itself, which can have child models. As a consequence, all the methods inherited from ILcdModel will only perform on the node and not on its children. For example calling ILcdModel.elements() on a node will return all the elements in the node, while calling it on a model list will return all the elements of all the sub models of the model list.

Their is also no restriction on the model reference of the child models, as it is the case on a TLcdModelList.

It is possible to attach listeners which will be notified of changes in the whole hierarchical structure (see addHierarchyModelContainerListener(ILcdModelContainerListener) and addHierarchyModelListener(ILcdModelListener)) or which will only be notified of changes in the node (see addModelListener(ILcdModelListener) and addModelContainerListener(ILcdModelContainerListener)).

A model node can contain data itself, but it can also be used as a container for models and contain no useful data itself. Such a node is empty, and should return true for isEmpty().

Since:

9.0

Nested Class Summary
- Nested classes/interfaces inherited from interface com.luciad.model.ILcdModel
  ILcdModel.Query

Field Summary
- Fields inherited from interface com.luciad.model.ILcdModel
  FIRE_LATER, FIRE_NOW, NO_EVENT

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`addElement(Object aElement, int aEventMode)` Adds the specified element to this model.
`void`	`addElements(Vector aElements, int aEventMode)` Adds all of the elements in the specified vector to this model.
`void`	`addHierarchyModelContainerListener(ILcdModelContainerListener aModelContainerListener)` Registers the given `ILcdModelContainerListener` to receive `TLcdModelContainerEvent`s from all the `ILcdModelTreeNode`s contained in the tree with this node as root node.
`void`	`addHierarchyModelListener(ILcdModelListener aModelListener)` Registers the given `ILcdModelListener` to receive `TLcdModelChangedEvent`s from all the `ILcdModel`s contained in the tree with this node as root node.
`boolean`	`addModel(ILcdModel aModel)` Adds the `ILcdModel aModel` as a child model to this `ILcdModelTreeNode`.
`void`	`addModelContainerListener(ILcdModelContainerListener aModelContainerListener)` Adds an `ILcdModelContainerListener` to this `ILcdModelContainer`.
`void`	`addModelListener(ILcdModelListener aModelListener)` Registers the specified model listener to receive notifications of model changes on this model.
`boolean`	`canAddElement(Object aElement)` Returns `true` if the specified element can be added to this model, `false` otherwise.
`boolean`	`canRemoveElement(Object aElement)` Returns `true` if the specified element can be removed from this model, `false` otherwise.
`void`	`dispose()` Disposes of this model and allows it to release any system resources that it is holding.
`void`	`elementChanged(Object aElement, int aEventMode)` Notifies this model that the specified element has changed.
`Enumeration`	`elements()` Returns an enumeration over all elements of this model.
`void`	`elementsChanged(Vector aElements, int aEventMode)` Notifies this model that the elements in the specified vector have changed.
`void`	`fireCollectedModelChanges()` Notifies all listeners that are registered on this model of all the changes that have been collected between the previous notification and now.
`ILcdModel`	`getModel(int aIndex)` Returns the child model at the given index.
`ILcdModelDescriptor`	`getModelDescriptor()` Returns the `ILcdModelDescriptor` providing meta information about this model and its elements.
`ILcdModelEncoder`	`getModelEncoder()` Returns, if available, a model encoder that is capable of encoding this model, (`encoder.canEncode(this)`), `null` otherwise.
`ILcdModelReference`	`getModelReference()` Returns the `ILcdModelReference` describing how the geometry of the elements contained in this model should be interpreted.
`boolean`	`isEmpty()` Returns `true` when the model node is only used as a container for other models, and contains no useful data itself, `false` otherwise.
`int`	`modelCount()` Returns the number of child models of this model node.
`Enumeration`	`models()` Returns an `Enumeration` of the child models of this `ILcdModelTreeNode`.
`void`	`removeAllElements(int aEventMode)` Removes all elements from this model.
`void`	`removeElement(Object aElement, int aEventMode)` Removes the specified element from this model.
`void`	`removeElements(Vector aElements, int aEventMode)` Removes all of the elements in the specified vector from this model.
`void`	`removeHierarchyModelContainerListener(ILcdModelContainerListener aModelContainerListener)` Unregisters the given `ILcdModelContainerListener` from receiving `TLcdModelContainerEvent`s for the tree with this node as root node.
`void`	`removeHierarchyModelListener(ILcdModelListener aModelListener)` Unregisters the given `ILcdModelListener` from receiving `TLcdModelChangedEvent`s for the tree with this node as root node.
`boolean`	`removeModel(ILcdModel aModel)` Removes the child model `aModel` from this `ILcdModelTreeNode`.
`void`	`removeModelContainerListener(ILcdModelContainerListener aModelContainerListener)` Removes an `ILcdModelContainerListener` from this `ILcdModelContainer`.
`void`	`removeModelListener(ILcdModelListener aModelListener)` Unregisters the specified model listener so that it no longer receives notifications of model changes on this model.

Methods inherited from interface com.luciad.model.ILcdModel
all, filter, getModelMetadata, query

Methods inherited from interface com.luciad.util.ILcdDisposable
close

Methods inherited from interface com.luciad.model.ILcdModelContainer
getModels

Methods inherited from interface com.luciad.model.ILcdModelProducerListener
modelProduced

- Method Detail
  - addHierarchyModelContainerListener
```
void addHierarchyModelContainerListener(ILcdModelContainerListener aModelContainerListener)
```
    Registers the given ILcdModelContainerListener to receive TLcdModelContainerEvents from all the ILcdModelTreeNodes contained in the tree with this node as root node. If the listener should only receive events originating from this model node, it should be adedd as a regular model listener (see addModelContainerListener(ILcdModelContainerListener)).
    
    The source ILcdModelContainer of the event can be retrieved by calling TLcdModelContainerEvent.getModelContainer() on the received TLcdModelContainerEvent.
    
    Parameters:
    
    aModelContainerListener - the listener
    
    See Also:
    
    removeHierarchyModelContainerListener(ILcdModelContainerListener)
  - removeHierarchyModelContainerListener
```
void removeHierarchyModelContainerListener(ILcdModelContainerListener aModelContainerListener)
```
    Unregisters the given ILcdModelContainerListener from receiving TLcdModelContainerEvents for the tree with this node as root node.
    
    Parameters:
    
    aModelContainerListener - the listener
    
    See Also:
    
    addHierarchyModelContainerListener(ILcdModelContainerListener)
  - addHierarchyModelListener
```
void addHierarchyModelListener(ILcdModelListener aModelListener)
```
    Registers the given ILcdModelListener to receive TLcdModelChangedEvents from all the ILcdModels contained in the tree with this node as root node. If the listener should only receive events originating from this model node, it should be added as a regular model listener (see addModelListener(ILcdModelListener)).
    
    The source ILcdModel of the event can be retrieved by calling TLcdModelChangedEvent.getModel() on the received TLcdModelChangedEvent.
    
    Parameters:
    
    aModelListener - the listener
    
    See Also:
    
    removeHierarchyModelListener(ILcdModelListener)
  - removeHierarchyModelListener
```
void removeHierarchyModelListener(ILcdModelListener aModelListener)
```
    Unregisters the given ILcdModelListener from receiving TLcdModelChangedEvents for the tree with this node as root node.
    
    Parameters:
    
    aModelListener - the listener
    
    See Also:
    
    addHierarchyModelListener(ILcdModelListener)
  - getModelReference
```
ILcdModelReference getModelReference()
```
    Returns the ILcdModelReference describing how the geometry of the elements contained in this model should be interpreted.
    This model reference is independent of the model reference(s) of the child models of this node.
    
    Specified by:
    
    getModelReference in interface ILcdModel
    
    Returns:
    
    the ILcdModelReference of this ILcdModel.
  - getModelDescriptor
```
ILcdModelDescriptor getModelDescriptor()
```
    Returns the ILcdModelDescriptor providing meta information about this model and its elements.
    This model descriptor is independent of the model descriptor(s) of the child models of this node.
    
    Specified by:
    
    getModelDescriptor in interface ILcdModel
    
    Returns:
    
    the ILcdModelDescriptor of this ILcdModel. Should not be null.
  - elements
```
Enumeration elements()
```
    Returns an enumeration over all elements of this model. The order in which the elements are enumerated is unspecified by default.
    The elements of the child model(s) are not included in this enumeration.
    
    Specified by:
    
    elements in interface ILcdModel
    
    Returns:
    
    an enumeration over all elements of this model. The elements of the child model(s) are not included in this enumeration.
  - addElement
```
void addElement(Object aElement,
                int aEventMode)
```
    Adds the specified element to this model.
    Models that support this operation may place limitations on what elements may be added to this model. For example, implementations that are based on a spatial indexing structure will require that elements implement ILcdBounded.
    When adding an element, the user should make sure that canAddElement(aElement) holds, and that the element's geometry is expressed in the same model reference as this model. It is generally undefined what happens if an invalid element is added.
    Implementations of this interface should clearly specify in their documentation any restrictions on what elements may be added. Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example, NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException), whenever possible.
    The element will only be added to this model node and not to any of the child model(s).
    
    Specified by:
    
    addElement in interface ILcdModel
    
    Parameters:
    
    aElement - the element to be added to this model.
    
    aEventMode - the mode for sending out the model change event. This can be FIRE_LATER or NO_EVENT.
    
    See Also:
    
    ILcdModel.canAddElement(Object)
  - canAddElement
```
boolean canAddElement(Object aElement)
```
    Returns true if the specified element can be added to this model, false otherwise.
    Note that this method generally does not validate whether the specified element is expressed in the same model reference as this model. It is the responsibility of the user of this model to make sure this precondition is fulfilled when an element is added to this model.
    This method only checks this model node and not any of the child models.
    
    Specified by:
    
    canAddElement in interface ILcdModel
    
    Parameters:
    
    aElement - the element to be verified.
    
    Returns:
    
    true if the specified element can be added to this model, false otherwise.
  - addElements
```
void addElements(Vector aElements,
                 int aEventMode)
```
    Adds all of the elements in the specified vector to this model. Models that support this operation may place limitations on what elements may be added to this model. For example, implementations that are based on a spatial indexing structure will require that elements implement ILcdBounded. Implementations of this interface should clearly specify in their documentation any restrictions on what elements may be added.
    The behavior of this operation is undefined if the specified vector is modified while the operation is in progress.
    The specified elements will be added to this model in the order they are specified in the vector. If an element cannot be added, this method will return at the first failure. Succeeding elements won't be added.
    Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example, NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException), whenever possible.
    The elements will only be added to this model node and not to any of the child model(s).
    
    Specified by:
    
    addElements in interface ILcdModel
    
    Parameters:
    
    aElements - the vector of elements to be added to this model.
    
    aEventMode - the mode for sending the model change events This can be FIRE_LATER or NO_EVENT.
    
    See Also:
    
    ILcdModel.canAddElement(Object)
  - removeElement
```
void removeElement(Object aElement,
                   int aEventMode)
```
    Removes the specified element from this model. If the specified element is not contained in this model, this method has no effect.
    Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example, NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException), whenever possible.
    The element will not be removed from the child model(s).
    
    Specified by:
    
    removeElement in interface ILcdModel
    
    Parameters:
    
    aElement - the element to be removed from this model.
    
    aEventMode - the mode for sending out the model change event. This can be FIRE_LATER or NO_EVENT.
    
    See Also:
    
    ILcdModel.canRemoveElement(Object)
  - canRemoveElement
```
boolean canRemoveElement(Object aElement)
```
    Returns true if the specified element can be removed from this model, false otherwise. Note that this method generally does not check whether the specified element is actually contained in this model.
    This method will only check this model node and not any of the child models.
    
    Specified by:
    
    canRemoveElement in interface ILcdModel
    
    Parameters:
    
    aElement - the element to be verified.
    
    Returns:
    
    true if the specified element can be removed from this model, false otherwise.
  - removeElements
```
void removeElements(Vector aElements,
                    int aEventMode)
```
    Removes all of the elements in the specified vector from this model. If one of the elements in the specified vector is not contained in this model, this element will be ignored.
    The behavior of this operation is undefined if the specified vector is modified while the operation is in progress.
    The specified elements will be removed from this model in the order they are specified in the vector. If an element cannot be removed, this method will return at the first failure. Succeeding elements won't be removed.
    Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example, NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException), whenever possible.
    The elements will not be removed from the child model(s).
    
    Specified by:
    
    removeElements in interface ILcdModel
    
    Parameters:
    
    aElements - the vector of elements to be removed from this model.
    
    aEventMode - the mode for sending out the model change event. This can be FIRE_LATER or NO_EVENT.
    
    See Also:
    
    ILcdModel.canRemoveElement(Object)
  - removeAllElements
```
void removeAllElements(int aEventMode)
```
    Removes all elements from this model.
    If an element cannot be removed, this method will return at the first failure. Succeeding elements won't be removed.
    Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example, NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException), whenever possible.
    It will not remove any elements from any of the child models.
    
    Specified by:
    
    removeAllElements in interface ILcdModel
    
    Parameters:
    
    aEventMode - the mode for sending out the model change event. This can be FIRE_LATER or NO_EVENT.
  - elementChanged
```
void elementChanged(Object aElement,
                    int aEventMode)
```
    Notifies this model that the specified element has changed.
    When an element in one the child models has changed, this method must be called on that child model and not on this node.
    
    Specified by:
    
    elementChanged in interface ILcdModel
    
    Parameters:
    
    aElement - the element that has changed.
    
    aEventMode - the mode for sending out the model change event. This can be FIRE_LATER or NO_EVENT.
  - elementsChanged
```
void elementsChanged(Vector aElements,
                     int aEventMode)
```
    Notifies this model that the elements in the specified vector have changed.
    When elements of one of the child models have changed, this method must be called on that child model and not on this node.
    
    Specified by:
    
    elementsChanged in interface ILcdModel
    
    Parameters:
    
    aElements - the vector of elements that have changed.
    
    aEventMode - the mode for sending out the model change event. This can be FIRE_LATER or NO_EVENT.
  - fireCollectedModelChanges
```
void fireCollectedModelChanges()
```
    Notifies all listeners that are registered on this model of all the changes that have been collected between the previous notification and now.
    Notice that both the hierarchical as the regular registered model listeners will be notified.
    
    Only the changes in this model node will be fired, not the changes in any of the child models.
    
    Specified by:
    
    fireCollectedModelChanges in interface ILcdModel
    
    See Also:
    
    ILcdModelListener.modelChanged(TLcdModelChangedEvent)
  - addModelListener
```
void addModelListener(ILcdModelListener aModelListener)
```
    Registers the specified model listener to receive notifications of model changes on this model.
    
    Model changes are sent out when an element has been added, removed or changed. Model changes can be sent out individually, grouped or silently applied without notifications, depending on the ILcdFireEventMode that was specified with the change.
    
    In case you need to register a listener which keeps a reference to an object with a shorter life-time than this model, you can use a ALcdWeakModelListener instance as model listener.
    
    The model listener will not receive any notifications of model changes in any of the child models. If the listener should also receive notifications about changes in the child models, it should be registered as a hierarchy listener (see addHierarchyModelListener(ILcdModelListener)).
    
    Specified by:
    
    addModelListener in interface ILcdModel
    
    Parameters:
    
    aModelListener - the ILcdModelListener to register on this model.
    
    See Also:
    
    ILcdModel.removeModelListener(com.luciad.model.ILcdModelListener), ILcdModelListener
  - removeModelListener
```
void removeModelListener(ILcdModelListener aModelListener)
```
    Unregisters the specified model listener so that it no longer receives notifications of model changes on this model.
    It is not possible to unregister hierarchy model listeners with this method. Use removeHierarchyModelListener(ILcdModelListener) for this purpose.
    
    Specified by:
    
    removeModelListener in interface ILcdModel
    
    Parameters:
    
    aModelListener - the ILcdModelListener to remove.
    
    See Also:
    
    ILcdModel.addModelListener(com.luciad.model.ILcdModelListener), ILcdModelListener
  - getModelEncoder
```
ILcdModelEncoder getModelEncoder()
```
    Returns, if available, a model encoder that is capable of encoding this model, (encoder.canEncode(this)), null otherwise.
    It is implementation-dependant whether this encoder considers the child models or not.
    
    Specified by:
    
    getModelEncoder in interface ILcdModel
    
    Returns:
    
    a model encoder that is capable of encoding this model if available, null otherwise.
  - modelCount
```
int modelCount()
```
    Returns the number of child models of this model node.
    
    Specified by:
    
    modelCount in interface ILcdModelContainer
    
    Returns:
    
    the number of child models of this model node.
  - addModel
```
boolean addModel(ILcdModel aModel)
```
    Adds the ILcdModel aModel as a child model to this ILcdModelTreeNode.
    
    Specified by:
    
    addModel in interface ILcdModelContainer
    
    Parameters:
    
    aModel - the model to be added.
    
    Returns:
    
    true if this collection of models changed as a result of the call
  - removeModel
```
boolean removeModel(ILcdModel aModel)
```
    Removes the child model aModel from this ILcdModelTreeNode.
    
    Specified by:
    
    removeModel in interface ILcdModelContainer
    
    Parameters:
    
    aModel - the model to be removed.
    
    Returns:
    
    true if a model was removed as a result of this call
  - getModel
```
ILcdModel getModel(int aIndex)
```
    Returns the child model at the given index.
    
    Specified by:
    
    getModel in interface ILcdModelContainer
    
    Parameters:
    
    aIndex - a valid index in this ILcdModelTreeNode
    
    Returns:
    
    the child model at the given index.
  - models
```
Enumeration models()
```
    Returns an Enumeration of the child models of this ILcdModelTreeNode.
    
    Specified by:
    
    models in interface ILcdModelContainer
    
    Returns:
    
    an Enumeration of the child models of this ILcdModelTreeNode.
  - addModelContainerListener
```
void addModelContainerListener(ILcdModelContainerListener aModelContainerListener)
```
    Adds an ILcdModelContainerListener to this ILcdModelContainer.
    It will only receive notifications of changes in this ILcdModelTreeNode and not of any changes in the state of the child model node(s). If this is required, the listener must be registered as a hierarchy listener (see addHierarchyModelContainerListener(ILcdModelContainerListener)).
    .
    
    Specified by:
    
    addModelContainerListener in interface ILcdModelContainer
    
    Parameters:
    
    aModelContainerListener - the listener to be added.
    
    See Also:
    
    ILcdModelContainer.removeModelContainerListener(com.luciad.model.ILcdModelContainerListener)
  - removeModelContainerListener
```
void removeModelContainerListener(ILcdModelContainerListener aModelContainerListener)
```
    Removes an ILcdModelContainerListener from this ILcdModelContainer.
    It is not possible to remove a hierarchy model container listener. Use removeHierarchyModelContainerListener(ILcdModelContainerListener) for this purpose.
    
    Specified by:
    
    removeModelContainerListener in interface ILcdModelContainer
    
    Parameters:
    
    aModelContainerListener - the listener to be removed.
    
    See Also:
    
    ILcdModelContainer.addModelContainerListener(com.luciad.model.ILcdModelContainerListener)
  - dispose
```
void dispose()
```
    Disposes of this model and allows it to release any system resources that it is holding. The result of calling any other method (other than finalize) on this model subsequent to a call to this method is undefined.
    Calling this method will not dispose any of the child models, or alter the hierarchical structure. If the child models should also be disposed, this method should be called on those models.
    
    Specified by:
    
    dispose in interface ILcdDisposable
    
    Specified by:
    
    dispose in interface ILcdModel
  - isEmpty
```
boolean isEmpty()
```
    Returns true when the model node is only used as a container for other models, and contains no useful data itself, false otherwise.
    
    Returns:
    
    true when the model node contains no useful data, false otherwise

LuciadFusionInterface ILcdModelTreeNode

Nested Class Summary

Nested classes/interfaces inherited from interface com.luciad.model.ILcdModel

Field Summary

Fields inherited from interface com.luciad.model.ILcdModel

Method Summary

Methods inherited from interface com.luciad.model.ILcdModel

Methods inherited from interface com.luciad.util.ILcdDisposable

Methods inherited from interface com.luciad.model.ILcdModelContainer

Methods inherited from interface com.luciad.model.ILcdModelProducerListener

Method Detail

addHierarchyModelContainerListener

removeHierarchyModelContainerListener

addHierarchyModelListener

removeHierarchyModelListener

getModelReference

getModelDescriptor

elements

addElement

canAddElement

addElements

removeElement

canRemoveElement

removeElements

removeAllElements

elementChanged

elementsChanged

fireCollectedModelChanges

addModelListener

removeModelListener

getModelEncoder

modelCount

addModel

removeModel

getModel

models

addModelContainerListener

removeModelContainerListener

dispose

isEmpty