Package com.luciad.format.dafift.decoder

Class TLcdDAFIFTVFRRouteDecoder

java.lang.Object
com.luciad.format.dafift.decoder.ALcdDAFIFTModelDecoder
com.luciad.format.dafift.decoder.TLcdDAFIFTVFRRouteDecoder
All Implemented Interfaces:
ILcdInputStreamFactoryCapable, ILcdModelDecoder
public class TLcdDAFIFTVFRRouteDecoder extends ALcdDAFIFTModelDecoder
Implementation of ILcdModelDecoder that decodes DAFIFT VFR route objects from the specified source directory. The decoded models have as model descriptor an instance of TLcdDAFIFVFRRouteModelListDescriptor.

The resulting model list will contain submodels for:

  • VFR routes,
  • offset routes,
  • aerodromes for which the VFR routes serve (optional).

The objects in decoded models are based on the AIS domain objects available in com.luciad.ais.model, which all implement ILcdDataObject. This interface provides a generic and format-independent way of accessing the type and properties (features) of a domain object.

For this handler, the types of the decoded objects are TLcdDAFIFTDataTypes.VFRRoute, TLcdDAFIFTDataTypes.VFROffsetRoute and TLcdDAFIFTDataTypes.VFRRoutePoint, which can also be retrieved through ILcdDataObject.getDataType(). The available properties of the objects are defined in TLcdDAFIFTVFRRouteDataProperties, TLcdDAFIFTVFROffsetRouteDataProperties and TLcdDAFIFTVFRRoutePointDataProperties. The values for these properties can be retrieved through ILcdDataObject.getValue(com.luciad.datamodel.TLcdDataProperty).

Next to ILcdDataObject, the objects in decoded models also implement ILcdFeatured, the former interface to access the properties (features) of a domain object. This is still fully supported, and explained in the following comments.

VFR route data includes data about aerodromes, served by the VFR and offset routes. To decode the available aerodrome information as well, use the setAddAerodromes method. For the aerodromes, there is no feature selection possible. All aerodrome features will be decoded.

The setVFRRouteFeaturesToBeDecoded and setOffsetRouteFeaturesToBeDecoded methods allow the user to specify which DAFIFT features are to be decoded into the featured model objects. If no features are specified, all features will be decoded.

The following fields (which are taken from the National Imagery and Mapping Agency (NIMA) Product Specifications for Digital Aeronautical Flight Information File (DAFIF), Eight Edition, January 2005) are supported by the decoder. The list indicates into which feature the fields are decoded. For VFR Arrival/Departure route fields:

VFR Arrival/Departure Segment route fields:

All DAFIFT decoders rely on a specific set of key features that uniquely define an object. This set of features must always be included in the set of features to be decoded. For VFR and offset routes, the key features are:

  • ILcdDAFIFVFRRouteFeature.AIRPORT_ID
  • ILcdDAFIFVFRRouteFeature.ROUTE_ID
Since:
7.2
See Also:

  • Constructor Details

    • TLcdDAFIFTVFRRouteDecoder

      @Deprecated public TLcdDAFIFTVFRRouteDecoder(ALcdAISObjectFactory aDomainFactory)
      Deprecated.
      Constructs a new TLcdDAFIFTVFRRouteDecoder object. The user should specify which aDomainFactory he or she wants to use to create the VFR routes, the aerodromes and the heliports.

      The addAerodromes property will be set to true.

      Parameters:
      aDomainFactory - The factory to be used to create the model objects.

    • TLcdDAFIFTVFRRouteDecoder

      public TLcdDAFIFTVFRRouteDecoder(TLcdAISDataObjectFactory aFactory)
      Constructs a new TLcdDAFIFTVFRRouteDecoder object. The user should specify which factory he or she wants to use to create the VFR routes, the aerodromes and the heliports.

      The addAerodromes property will be set to true.

      Parameters:
      aFactory - The factory to be used to create the model objects.

    • TLcdDAFIFTVFRRouteDecoder

      @Deprecated public TLcdDAFIFTVFRRouteDecoder(ALcdAISObjectFactory aDomainFactory, boolean aAddAerodromes)
      Deprecated.
      Constructs a new TLcdDAFIFTVFRRouteDecoder object. The user should specify which aDomainFactory he or she wants to use to create the VFR routes, the aerodromes and the heliports.
      Parameters:
      aDomainFactory - The factory to be used to create the model objects.
      aAddAerodromes - A boolean indicating whether a submodel containing the aerodromes should be added or not.

    • TLcdDAFIFTVFRRouteDecoder

      public TLcdDAFIFTVFRRouteDecoder(TLcdAISDataObjectFactory aFactory, boolean aAddAerodromes)
      Constructs a new TLcdDAFIFTVFRRouteDecoder object. The user should specify which aDomainFactory he or she wants to use to create the VFR routes, the aerodromes and the heliports.
      Parameters:
      aFactory - The factory to be used to create the model objects.
      aAddAerodromes - A boolean indicating whether a submodel containing the aerodromes should be added or not.

  • Method Details

    • getDisplayName

      public String getDisplayName()
      Description copied from interface: ILcdModelDecoder
      Returns a short, displayable name for the format that is decoded by this ILcdModelDecoder.
      Specified by:
      getDisplayName in interface ILcdModelDecoder
      Overrides:
      getDisplayName in class ALcdDAFIFTModelDecoder
      Returns:
      the displayable name of this ILcdModelDecoder.

    • decode

      public ILcdModel decode(String aSource) throws IOException
      Returns a model list containing one or more submodels. Each submodel contains domain objects of the same type.

      The models will be build by looping through the records found in the source file. Each record that passes the record filter (getRecordFilter()) will be decoded. A decoded record needs to pass two additional filters (a model filter getModelFilter() and a bounds filter getDecodingBounds()) before it can be added to the model.

      Furthermore, an error message will be initialized and filled with reports about errors occurred during the decode process. By default, all reports will be added into the error message. The method setMaxNumberOfErrorReports(int) can be used to adjust this setting.

      If the property 'addAerodrome' is set to true, the aerodrome and heliport model are decoded first, before the actual decoding starts.

      Specified by:
      decode in interface ILcdModelDecoder
      Parameters:
      aSource - Either the directory containing the DAFIFT source file to decode or the DAFIFT source file itself.
      Returns:
      the model build by reading the file found with the given source.
      Throws:
      IOException - if an error occurs during the reading process.
      See Also:

    • setVFRRouteDefaultDisplayNameIndex

      public void setVFRRouteDefaultDisplayNameIndex(int aIndex)
      Specifies the index of the feature to be the VFR route display name.
      Parameters:
      aIndex - The index of the feature to be the VFR route display name.

    • setOffsetRouteDefaultDisplayNameIndex

      public void setOffsetRouteDefaultDisplayNameIndex(int aIndex)
      Specifies the index of the feature to be the offset route display name.
      Parameters:
      aIndex - The index of the feature to be the offset route display name.

    • setVFRRouteFeaturesToBeDecoded

      public void setVFRRouteFeaturesToBeDecoded(String[] aFeaturesToBeDecoded)
      Specifies the VFR route features to be decoded into the model objects.

      Please make sure that the AIRPORT_ID and ROUTE_ID features are in your list of features to be decoded!

      Parameters:
      aFeaturesToBeDecoded - A list of features that should be decoded into the VFR route model objects.

    • setOffsetRouteFeaturesToBeDecoded

      public void setOffsetRouteFeaturesToBeDecoded(String[] aFeaturesToBeDecoded)
      Specifies the offset route features to be decoded into the model objects.

      Please make sure that the AIRPORT_ID and ROUTE_ID features are in your list of features to be decoded!

      Parameters:
      aFeaturesToBeDecoded - A list of features that should be decoded into the offset route model objects.

    • isAddAerodromes

      public boolean isAddAerodromes()
      Returns a boolean indicating whether the submodel of aerodromes will be added or not. If the addAerodromes property is true, an extra submodel will be created. This model will contain the aerodromes for which a VFR route serves.

      The aerodromes in the model are retrieved from the aerodrome and the heliport model decoded by this decoder using the source directory to be decoded.

      Returns:
      whether the submodel of aerodromes will be added or not.
      See Also:

    • setAddAerodromes

      public void setAddAerodromes(boolean aValue)
      Specifies whether a submodel of aerodromes should be added.
      Parameters:
      aValue - A flag indicating if a submodel of aerodromes should be added.
      See Also:

    • getUniqueKeyFeatureNames

      public String[] getUniqueKeyFeatureNames(int aIndex)
      Returns for the given submodel the array of String objects containing the names of the features that will be used as a unique key to insert objects into the submodel.
      Parameters:
      aIndex - The index of the submodel whose unique key feature names are being retrieved.
      Returns:
      for the given submodel the unique key feature names.

    • canDecodeSource

      public boolean canDecodeSource(String aSource)
      Returns true if the specified source is:
      • A file with the specific name corresponding to the object type of this decoder
      • A directory containing such a file
      • A .toc file in a directory, pointing to such a file
      Parameters:
      aSource - the name of the source file or directory that you want to decode
      Returns:
      a boolean indicating whether the given source can be decoded

    • getDomainFactory

      @Deprecated public ALcdAISObjectFactory getDomainFactory()
      Deprecated.
      Use getDataObjectFactory()
      Returns the factory that is used to create domain objects.
      Returns:
      the factory that is used to create domain objects.
      See Also:

    • setDomainFactory

      @Deprecated public void setDomainFactory(ALcdAISObjectFactory aDomainFactory)
      Deprecated.
      Use setDataObjectFactory(TLcdAISDataObjectFactory)
      Specifies the domain factory.

      The domain factory will be used to create the domain objects decoded by this DAFIFT decoder.

      Parameters:
      aDomainFactory - The factory that will be used to create domain objects.
      See Also:

    • getDataObjectFactory

      public TLcdAISDataObjectFactory getDataObjectFactory()
      Returns the factory that is used to create domain objects.
      Returns:
      the factory that is used to create domain objects.
      See Also:

    • setDataObjectFactory

      public void setDataObjectFactory(TLcdAISDataObjectFactory aFactory)
      Specifies the data factory.

      The data factory will be used to create the domain objects decoded by this DAFIFT decoder.

      Decoders equipped with a data object factory that is not null, will NOT use their associated domain factory (see getDomainFactory()).

      Parameters:
      aFactory - The factory that will be used to create domain objects.
      See Also:

    • getInputStreamFactory

      public ILcdInputStreamFactory getInputStreamFactory()
      Returns the input stream factory that is currently used for creating the input streams for the given source names.
      Specified by:
      getInputStreamFactory in interface ILcdInputStreamFactoryCapable
      Returns:
      the input stream factory that is currently used.
      See Also:

    • setInputStreamFactory

      public void setInputStreamFactory(ILcdInputStreamFactory aInputStreamFactory)
      Sets the input stream factory that will be used for creating the input streams for the given source names.
      Specified by:
      setInputStreamFactory in interface ILcdInputStreamFactoryCapable
      Parameters:
      aInputStreamFactory - The input stream factory to be used.
      See Also:

    • getRecordFilter

      public ILcdDAFIFTRecordFilter getRecordFilter()
      Returns the record filter that is currently used.
      Returns:
      the record filter that is currently used.
      See Also:

    • setRecordFilter

      public void setRecordFilter(ILcdDAFIFTRecordFilter aRecordFilter)
      Specifies a filter to be used while creating the model. Only records that pass through this filter will be decoded into model objects.
      Parameters:
      aRecordFilter - The record filter that should be passed before a record can be decoded.
      See Also:

    • getMaxNumberOfErrorReports

      public int getMaxNumberOfErrorReports()
      Returns the number of error reports to be added to the error message. If there are more errors than the maxNumberOfErrorReports property, they won't be stored and you won't be able to see these errors in the error message after the decoding process.
      Returns:
      the number of error reports to be added to the error message.
      See Also:

    • setMaxNumberOfErrorReports

      public void setMaxNumberOfErrorReports(int aMaxNumberOfErrorReports)
      Specifies a value for the maximum number of error reports. If a negative value is set, all reported errors will be added to the error message.
      Parameters:
      aMaxNumberOfErrorReports - The maximum number of error reports to be added to the error message.
      See Also:

    • getErrorMessage

      public String getErrorMessage()
      Returns the error message of the last decode call.

      Note that the error message can only be retrieved once after a decode call.

      Returns:
      a String object containing the errors occurred during the last decode process.