TLcdASDIFlightPlan (LuciadLightspeed API documentation)

java.lang.Object
- com.luciad.format.asdi.TLcdASDIFlightPlan

All Implemented Interfaces:

ILcdDataObject, ILcdBounded, ILcdPointList, ILcdCache, ~~ILcdFeatured~~ , Serializable, Cloneable
```
public class TLcdASDIFlightPlan
extends Object
implements ILcdPointList, ILcdBounded, 
ILcdFeatured
, Cloneable, ILcdDataObject, ILcdCache
```
Time-dependent view on a TLcdASDIFlightPlanHistory. It represents the intended route and flight plan features of the TLcdASDIFlightPlanHistory at a certain index.
A TLcdASDIFlightPlanHistory represents the whole history of a flight plan, including an intended route and additional information (=features) for every timestamp. This TLcdASDIFlightPlan however represents a flight plan of a TLcdASDIFlightPlanHistory at a certain time, so it represents a TLcdASDIFlightPlanHistory at a certain index. All data made available by a TLcdASDIFlightPlan is in fact extracted from the TLcdASDIFlightPlanHistory on which the TLcdASDIFlightPlan is based.
The history can be retrieved using getFlightPlanHistory(), the index in the history with getFlightPlanHistoryIndex().
The method isActive() allows to check if a flight plan is active. A flight plan is considered active when it has a valid history index.
Use setFlightPlanHistoryIndex(int) to update the state of a flight plan to a given index. Note that the method TLcdASDIFlightPlanHistory.getIndexForTimeStamp(long) can be used to retrieve the index for a given time value.
The properties of a flight plan can be accessed through the ILcdDataObject interface. The data type of a track will be TLcdASDIFlightPlanDataTypes.FlightPlanType . The values of the properties can be retrieved using the ILcdDataObject.getValue(com.luciad.datamodel.TLcdDataProperty) method. The property values of a message can be accessed using the getMessageType(int) and getMessageValue(int, com.luciad.datamodel.TLcdDataProperty) methods. The message type will be one of the data types found in TLcdASDIMessageDataTypes.
The flight plan properties can also be accessed through the ILcdFeatured interface. The features of the flight plan messages that make up the flight plan can be accessed through the methods getMessageCount(), getMessageFeatureCount(int) and getMessageFeature(int, int). An overview of all flight plan features can be found in ILcdASDIFlightPlanFeatures and of all flight plan message features in ILcdASDIFlightPlanMessageFeatures. Note that the ILcdFeatured interface only exists for backwards compatibility. It is recommended to use the ILcdDataObject instead, as described in the previous paragraph.
Models with TLcdASDIFlightPlan objects have model descriptors that are TLcdASDIFlightPlanModelDescriptor. They describe the features (available through the ILcdFeatured interface) of the TLcdASDIFlightPlan objects. Moreover they have a method getMessageFeaturedDescriptor(String aMessageType) that allows to retrieve the ILcdFeaturedDescriptor for the flight plan message features. The message type that must be provided as argument can be obtained from getMessageType(int aMessageIndex).

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`TLcdASDIFlightPlan(TLcdASDIFlightPlanHistory aFlightPlanHistory)` Constructs a new `TLcdASDIFlightPlan` that has a reference to a `TLcdASDIFlightPlanHistory`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`canSetFeature(int aFeatureIndex)` Checks whether the flight plan feature with index `aFeatureIndex` of the flight plan at the current flight plan history index is editable.
`void`	`clearCache()` Clears the cache.
`Object`	`clone()` Creates a shallow clone of this flightplan.
`ILcdBounds`	`getBounds()` Returns the `ILcdBounds` by which the geometry of this `ILcdBounded` object is bounded.
`Object`	`getCachedObject(Object aKey)` Looks up and returns the cached Object corresponding to the given key.
`TLcdDataType`	`getDataType()` Returns the type of this data object.
`Object`	`getFeature(int aFeatureIndex)` Returns the value of the flight plan feature at index `aFeatureIndex` for the flight plan at the current flight plan history index.
`int`	`getFeatureCount()` Returns the number of flight plan features from the associated flight plan history.
`TLcdASDIFlightPlanHistory`	`getFlightPlanHistory()` Returns the `TLcdASDIFlightPlanHistory` for which this `TLcdASDIFlightPlan` shows a window.
`int`	`getFlightPlanHistoryIndex()` Returns the index for which this flight plan represents the flight plan history.
`int`	`getMessageCount()` Returns the number of messages in this flight plan.
`TLcdDataType`	`getMessageDataType(int aMessageIndex)` Returns the `TLcdDataType`of the message at the given index.
`Object`	`getMessageFeature(int aMessageIndex, int aFeatureIndex)` Retrieves the message feature indicated by `aFeatureIndex` for the message with index `aMessageIndex`.
`int`	`getMessageFeatureCount(int aMessageIndex)` Returns the number of features in the message with index `aMessageIndex`.
`String`	`getMessageType(int aMessageIndex)` Returns a `String` indicating the type of the message with index `aMessageIndex`.
`Object`	`getMessageValue(int aMessageIndex, TLcdDataProperty aProperty)` Retrieves the value of the `TLcdDataProperty` for a given message index.
`ILcdPoint`	`getPoint(int aPointIndex)` Retrieves the intended route position indicated by `aPointIndex`.
`int`	`getPointCount()` Returns the number of points in the intended route.
`Object`	`getValue(String aPropertyName)` Convenience method that returns the value of the property with the given name.
`Object`	`getValue(TLcdDataProperty aProperty)` Returns the value of the given property.
`boolean`	`hasValue(String aPropertyName)` Indicates whether this data object has a value for the given property.
`boolean`	`hasValue(TLcdDataProperty aProperty)` Indicates whether this data object has a value for the given property.
`void`	`insertIntoCache(Object aKey, Object aObject)` Inserts a cache Object corresponding to the given key Object.
`boolean`	`isActive()` Returns whether or not this flight plan is still active.
`Object`	`removeCachedObject(Object aKey)` Looks up and removes the cached Object corresponding to the given key.
`void`	`setFeature(int aFeatureIndex, Object aObject)` Sets the value of the flight plan feature with index `aFeatureIndex` for the flight plan at the current flight plan history index.
`void`	`setFlightPlanHistoryIndex(int aFlightPlanHistoryIndex)` Updates the state of this flight plan so that it reflects the state of the flight plan history at the given aFlightPlanHistoryIndex.
`void`	`setValue(String aPropertyName, Object aValue)` Convenience method that sets the value of the property with the given name.
`void`	`setValue(TLcdDataProperty aProperty, Object aValue)` Sets the value of the given property for this data object.

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.luciad.shape.ILcdPointList
getPointSFCT, getX, getY, getZ

- Constructor Detail
  - TLcdASDIFlightPlan
```
public TLcdASDIFlightPlan(TLcdASDIFlightPlanHistory aFlightPlanHistory)
```
    Constructs a new TLcdASDIFlightPlan that has a reference to a TLcdASDIFlightPlanHistory.
    
    Parameters:
    
    aFlightPlanHistory - The TLcdASDIFlightPlanHistory on which this TLcdASDIFlightPlan is based.
- Method Detail
  - getFlightPlanHistoryIndex
```
public int getFlightPlanHistoryIndex()
```
    Returns the index for which this flight plan represents the flight plan history.
    
    Returns:
    
    the index for which this flight plan represents the flight plan history.
  - setFlightPlanHistoryIndex
```
public void setFlightPlanHistoryIndex(int aFlightPlanHistoryIndex)
```
    Updates the state of this flight plan so that it reflects the state of the flight plan history at the given aFlightPlanHistoryIndex.
    
    It updates the features and the intended route of this flight plan, according to the given index.
    
    Note that the method TLcdASDIFlightPlanHistory.getIndexForTimeStamp(long) can be used to retrieve the index for a given time value.
    
    Parameters:
    
    aFlightPlanHistoryIndex - The flight plan index of the flight plan history, 0 <= aFlightPlanHistoryIndex < getFlightPlanCount(). Set this to -1 to mark the flight plan as inactive.
  - getFeatureCount
```
public int getFeatureCount()
```
    Returns the number of flight plan features from the associated flight plan history. So it is equivalent to getFlightPlanHistory().getFlightPlanFeatureCount().
    
    See TLcdASDIFlightPlanHistory.getFlightPlanFeatureCount() for a more detailed description.
    
    Specified by:
    
    getFeatureCount in interface ILcdFeatured
    
    Returns:
    
    the number of flight plan features from the associated flight plan history.
  - getFeature
```
public Object getFeature(int aFeatureIndex)
                  throws IndexOutOfBoundsException
```
    Returns the value of the flight plan feature at index aFeatureIndex for the flight plan at the current flight plan history index. So it is equivalent to getFlightPlanHistory().getFlightPlanFeature( getFlightPlanHistoryIndex(), aFeatureIndex ).
    
    See TLcdASDIFlightPlanHistory.getFlightPlanFeature(int aIndex, int aFeatureIndex) for a more detailed description.
    
    Specified by:
    
    getFeature in interface ILcdFeatured
    
    Parameters:
    
    aFeatureIndex - The index of the feature, must be smaller than getFeatureCount().
    
    Returns:
    
    The feature object on index aFeatureIndex for the flight plan at the current flight plan history index.
    
    Throws:
    
    IndexOutOfBoundsException - when an index is chosen greater than the result of getFeatureCount.
    
    See Also:
    
    ILcdFeatured.setFeature(int, java.lang.Object)
  - canSetFeature
```
public boolean canSetFeature(int aFeatureIndex)
```
    Checks whether the flight plan feature with index aFeatureIndex of the flight plan at the current flight plan history index is editable.
    
    See getFeatureCount() and getFeature(int aFeatureIndex) for more information on flight plan features.
    
    None of the flight plan features are editable, so always returns false.
    
    Specified by:
    
    canSetFeature in interface ILcdFeatured
    
    Parameters:
    
    aFeatureIndex - a valid feature index, must be smaller than getFeatureCount().
    
    Returns:
    
    whether the specified feature is editable, always returns false.
  - setFeature
```
public void setFeature(int aFeatureIndex,
                       Object aObject)
                throws IllegalArgumentException
```
    Sets the value of the flight plan feature with index aFeatureIndex for the flight plan at the current flight plan history index.
    
    See getFeatureCount() and getFeature(int aFeatureIndex) for more information on flight plan features.
    
    None of the flight plan features are editable, so calling this method always results in throwing an IllegalArgumentException.
    
    Specified by:
    
    setFeature in interface ILcdFeatured
    
    Parameters:
    
    aFeatureIndex - a valid feature index, must be smaller than getFeatureCount().
    
    aObject - the new value of the feature.
    
    Throws:
    
    IllegalArgumentException - if the feature can't be set.
    
    See Also:
    
    ILcdFeatured.getFeature(int), ILcdFeatured.canSetFeature(int)
  - getFlightPlanHistory
```
public TLcdASDIFlightPlanHistory getFlightPlanHistory()
```
    Returns the TLcdASDIFlightPlanHistory for which this TLcdASDIFlightPlan shows a window.
    
    A TLcdASDIFlightPlan represents a flight plan at a certain time and is implemented as a TLcdASDIFlightPlanHistory at a certain index. Every TLcdASDIFlightPlan has a reference to exactly one TLcdASDIFlightPlanHistory.
    
    Returns:
    
    The TLcdASDIFlightPlanHistory that is referenced by this TLcdASDIFlightPlan.
  - getPointCount
```
public int getPointCount()
```
    Returns the number of points in the intended route.
    
    Specified by:
    
    getPointCount in interface ILcdPointList
    
    Returns:
    
    the number of points in the intended route.
  - getPoint
```
public ILcdPoint getPoint(int aPointIndex)
                   throws IndexOutOfBoundsException
```
    Retrieves the intended route position indicated by aPointIndex.
    
    Specified by:
    
    getPoint in interface ILcdPointList
    
    Parameters:
    
    aPointIndex - Determines what particular point you want to retrieve. Must be smaller than getPointCount().
    
    Returns:
    
    The requested intended route position.
    
    Throws:
    
    IndexOutOfBoundsException - if the given index is out of bounds.
  - getMessageCount
```
public int getMessageCount()
```
    Returns the number of messages in this flight plan.
    
    Returns:
    
    the number of messages in this flight plan.
    
    See Also:
    
    getMessageFeatureCount(int), getMessageFeature(int, int), getMessageType(int)
  - getMessageFeatureCount
```
public int getMessageFeatureCount(int aMessageIndex)
```
    Returns the number of features in the message with index aMessageIndex.
    
    Parameters:
    
    aMessageIndex - The index of the message for which you want to know the feature count. Must be smaller than getMessageCount().
    
    Returns:
    
    the number of features in the specified message.
    
    See Also:
    
    getMessageFeature(int, int)
  - getMessageFeature
```
public Object getMessageFeature(int aMessageIndex,
                                int aFeatureIndex)
```
    Retrieves the message feature indicated by aFeatureIndex for the message with index aMessageIndex.
    
    Parameters:
    
    aMessageIndex - The index of the message for which you want to know the feature value. Must be smaller than getMessageCount().
    
    aFeatureIndex - Determines what particular feature value you want to retrieve. Must be smaller than getMessageFeatureCount(int).
    
    Returns:
    
    The requested feature for the specified message.
  - getMessageValue
```
public Object getMessageValue(int aMessageIndex,
                              TLcdDataProperty aProperty)
```
    Retrieves the value of the TLcdDataProperty for a given message index.
    The data property must be of the correct data type. To find the data type, use the getMessageDataType(int) method. The properties for all data types returned by this method are described in TLcdASDIMessageDataTypes.
    
    Parameters:
    
    aMessageIndex - The index of the message for which you want to know the property value. Must be smaller than getMessageCount().
    
    aProperty - a TLcdDataProperty that was declared in the data type returned by getMessageDataType(int)
    
    Returns:
    
    The requested value for the specified message and message property, or null if the message index was out of bounds.
    
    Throws:
    
    IllegalArgumentException - when the given data property was not declared in the TLcdDataType of the message. To make sure this does not happen, use getMessageDataType(int) to obtain the data type of the message beforehand.
    
    See Also:
    
    for more info on the properties and data types of a message
  - getMessageType
```
public String getMessageType(int aMessageIndex)
```
    Returns a String indicating the type of the message with index aMessageIndex. Message types correspond with the abbreviations of the messages used in the specification : FZ, AF, DZ, UZ, AZ, RZ or RT. For instance, the message type of FZ messages is the String "FZ".
    
    Parameters:
    
    aMessageIndex - The index of the message for which you want to know the type. Must be smaller than getMessageCount().
    
    Returns:
    
    the String indicating the type of the specified message, null if not known.
  - getMessageDataType
```
public TLcdDataType getMessageDataType(int aMessageIndex)
```
    Returns the TLcdDataTypeof the message at the given index. This data type will be supertyped by TLcdASDIMessageDataTypes.AbstractASDIMessageType, and will be one of the TLcdDataType instances found in the TLcdASDIMessageDataTypes class.
    
    Parameters:
    
    aMessageIndex - The index of the message for which you want to know the type. Must be smaller than getMessageCount().
    
    Returns:
    
    the TLcdDataType of the message, of null if not known.
    
    See Also:
    
    TLcdASDIMessageDataTypes
  - getBounds
```
public ILcdBounds getBounds()
```
    Returns the ILcdBounds by which the geometry of this ILcdBounded object is bounded.
    If the geometry does not allow retrieving valid bounds (for example a polyline with 0 points) the return value is unspecified. It is highly recommended to return an undefined bounds. You can create undefined bounds using the default constructors of TLcdLonLatBounds or TLcdXYBounds.
    The bounds include the points of the intended route (accessable through getPointCount() and getPoint(int)).
    
    Specified by:
    
    getBounds in interface ILcdBounded
    
    Returns:
    
    the ILcdBounds by which the geometry of this ILcdBounded object is bounded.
  - isActive
```
public boolean isActive()
```
    Returns whether or not this flight plan is still active. A flight plan is considered active if its timestamp lies within the TLcdASDIFlightPlanHistory.getBeginTime and TLcdASDIFlightPlanHistory.getEndTime, this is, it represents the flight plan history at a certain valid index. The data of an inactive flight plan should not be used or interpreted in any way.
    
    Returns:
    
    true if this flight plan represents the flight plan history at a certain valid index, false if not.
  - clone
```
public Object clone()
```
    Creates a shallow clone of this flightplan. The flightplan history will be shared between this instance and the cloned instance.
    
    Overrides:
    
    clone in class Object
    
    Returns:
    
    A shallow clone of this flightplan. This will never be null.
  - insertIntoCache
```
public void insertIntoCache(Object aKey,
                            Object aObject)
```
    Description copied from interface: ILcdCache
    
    Inserts a cache Object corresponding to the given key Object.
    
    Specified by:
    
    insertIntoCache in interface ILcdCache
    
    Parameters:
    
    aKey - the key Object that will be used to identify the Object. The key must therefore be a unique identifier, typically the caller itself: insertIntoCache(this, ...).
    
    aObject - the Object to be cached.
  - getCachedObject
```
public Object getCachedObject(Object aKey)
```
    Description copied from interface: ILcdCache
    
    Looks up and returns the cached Object corresponding to the given key.
    
    Specified by:
    
    getCachedObject in interface ILcdCache
    
    Parameters:
    
    aKey - the key Object that was used for storing the cache Object.
    
    Returns:
    
    the cached Object, or null if there is no Object corresponding to the given key.
  - removeCachedObject
```
public Object removeCachedObject(Object aKey)
```
    Description copied from interface: ILcdCache
    
    Looks up and removes the cached Object corresponding to the given key.
    
    Specified by:
    
    removeCachedObject in interface ILcdCache
    
    Parameters:
    
    aKey - the key Object that was used for storing the cache Object.
    
    Returns:
    
    the cached Object, or null if there was no Object corresponding to the given key.
  - clearCache
```
public void clearCache()
```
    Description copied from interface: ILcdCache
    
    Clears the cache.
    
    Specified by:
    
    clearCache in interface ILcdCache
  - getDataType
```
public TLcdDataType getDataType()
```
    Description copied from interface: ILcdDataObject
    
    Returns the type of this data object. This can never be null.
    
    Specified by:
    
    getDataType in interface ILcdDataObject
    
    Returns:
    
    the type of this data object
  - getValue
```
public Object getValue(TLcdDataProperty aProperty)
```
    Description copied from interface: ILcdDataObject
    
    Returns the value of the given property.
    
    If the property is a collection, the returned value will never be null. If the property has not been set, an empty collection of the appropriate type will be returned (Set, List or Map).
    
    The property must not be null, and must be declared in the data object's type or in one of its super types. Otherwise an IllegalArgumentException is thrown.
    
    Specified by:
    
    getValue in interface ILcdDataObject
    
    Parameters:
    
    aProperty - the property for which the value is to be returned
    
    Returns:
    
    the value of the given property for this data object
  - setValue
```
public void setValue(TLcdDataProperty aProperty,
                     Object aValue)
```
    Description copied from interface: ILcdDataObject
    
    Sets the value of the given property for this data object. The implementation is allowed to throw an exception if the given value can't be set.
    The given property must be declared in the data object's type or in one of its super types. In other words, getDataType().getProperties().contains( aProperty ) should always be true. Otherwise, the implementation should throw an IllegalArgumentException.
    
    Specified by:
    
    setValue in interface ILcdDataObject
    
    Parameters:
    
    aProperty - the property for which the value is to be set
    
    aValue - the value to set
    
    See Also:
    
    TLcdDataType.getProperty(String)
  - getValue
```
public Object getValue(String aPropertyName)
```
    Description copied from interface: ILcdDataObject
    
    Convenience method that returns the value of the property with the given name.
    If more than one property exists with the given name, the most specific property should be used (this is the property defined by the most specialized type in this object's data type hierarchy).
    See ILcdDataObject.getValue(TLcdDataProperty) for more information.
    
    Specified by:
    
    getValue in interface ILcdDataObject
    
    Parameters:
    
    aPropertyName - the name of the property of which the value is to be returned
    
    Returns:
    
    the value of the property with the given name
    
    See Also:
    
    TLcdDataType.getProperty(String)
  - setValue
```
public void setValue(String aPropertyName,
                     Object aValue)
```
    Description copied from interface: ILcdDataObject
    
    Convenience method that sets the value of the property with the given name.
    If more than one property exists with the given name, the most specific property should be used (this is the property defined by the most specialized type in this object's data type hierarchy).
    See ILcdDataObject.setValue(TLcdDataProperty, Object) for more information.
    
    Specified by:
    
    setValue in interface ILcdDataObject
    
    Parameters:
    
    aPropertyName - the name of the property of which the value is to be set
    
    aValue - the value to set
  - hasValue
```
public boolean hasValue(TLcdDataProperty aProperty)
```
    Description copied from interface: ILcdDataObject
    Indicates whether this data object has a value for the given property.
    - aProperty is from the right data type, and this instance has a value for it: returns true
    - aProperty is from the right data type, and this instance has no value for it: returns false
    - aProperty is not from the right data type: not allowed, you will get IllegalArgumentException
    - aProperty is null: not allowed, you will get NullPointerException
    A multivalued property is considered to have a value if it has at least one value.
    Specified by:
    
    hasValue in interface ILcdDataObject
    
    Parameters:
    
    aProperty - the property for which to return whether a value is present or not.
    
    Returns:
    
    true if this data object has a value for the given property, false otherwise.
  - hasValue
```
public boolean hasValue(String aPropertyName)
```
    Description copied from interface: ILcdDataObject
    
    Indicates whether this data object has a value for the given property.
    See ILcdDataObject.hasValue(TLcdDataProperty) for more information.
    
    Specified by:
    
    hasValue in interface ILcdDataObject
    
    Parameters:
    
    aPropertyName - the name of the property for which to return whether a value is present or not.
    
    Returns:
    
    true if this data object has a value for the property with the given name, false otherwise.

Radar ConnectorsClass TLcdASDIFlightPlan

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.luciad.shape.ILcdPointList

Constructor Detail

TLcdASDIFlightPlan

Method Detail

getFlightPlanHistoryIndex

setFlightPlanHistoryIndex

getFeatureCount

getFeature

canSetFeature

setFeature

getFlightPlanHistory

getPointCount

getPoint

getMessageCount

getMessageFeatureCount

getMessageFeature

getMessageValue

getMessageType

getMessageDataType

getBounds

isActive

clone

insertIntoCache

getCachedObject

removeCachedObject

clearCache

getDataType

getValue

setValue

getValue

setValue

hasValue

hasValue