public class TLcdDAFIFAerodromeDecoder extends ALcdDAFIFAerodromeDecoder
ALcdDAFIFAerodromeDecoder decodes
aerodromes from a DAFIF source file. Decoded models have as model descriptor
an instance of TLcdDAFIFAerodromeModelDescriptor.
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 decoder, the type of the decoded objects is TLcdDAFIFDataTypes.Aerodrome,
which can also be retrieved through ILcdDataObject.getDataType().
The available properties of the objects are defined in TLcdDAFIFAerodromeDataProperties.
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.
The setAerodromeFeaturesToBeDecoded method allows
the user to specify which DAFIF features are decoded into the featured model objects.
If no features to be decoded are specified, all features will be decoded.
The following fields (taken from the National Imagery and Mapping Agency (NIMA) Product Specifications for Digital Aeronautical Flight Information File (DAFIF), Seventh Edition, May 2001) are supported by the decoder. The list indicates into which feature the fields are decoded.
DAFIF 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 aerodromes the key features are:
In addition to the fields of the aerodrome records, this class also decodes communication records
as described in the specifications of formats 16,17,18 of FILE0 (airports) and 13,14,15 of FILE1 (heliports).
The communication objects corresponding to an aerodrome are stored in a Vector feature
of the aerodrome:
setCommunicationFeaturesToBeDecoded.
If no communication features to be decoded are specified, all features will be decoded.
The following fields of the communication records are supported by the decoder. The list indicates into which communication feature the fields are decoded.
In the aerodrome's vector of communication objects, each element is of type
TLcdFeaturedService.
Each of these elements contains all the communication features specified in
setCommunicationFeaturesToBeDecoded
but some of the features may have null values, depending on the communication record
from which they have been decoded.
fCommunicationFeaturesToBeDecoded, fCommunicationFeaturesType1, fCommunicationFeaturesType2, fCommunicationFeaturesType3, fCommunicationFeaturesType4DAFIF_PROP_EXTENSION, fRecordCount| Constructor and Description |
|---|
TLcdDAFIFAerodromeDecoder(ALcdAISObjectFactory aFactory)
Deprecated.
|
TLcdDAFIFAerodromeDecoder(ALcdAISObjectFactory aFactory,
Properties aDAFIFProperties)
Deprecated.
|
TLcdDAFIFAerodromeDecoder(TLcdAISDataObjectFactory aFactory)
Creates a new
TLcdDAFIFAerodromeDecoder object. |
TLcdDAFIFAerodromeDecoder(TLcdAISDataObjectFactory aFactory,
Properties aDAFIFProperties)
Creates a new
TLcdDAFIFAerodromeDecoder object. |
| Modifier and Type | Method and Description |
|---|---|
protected ILcdModelDescriptor |
createModelDescriptor(String aSource)
Creates and returns the model descriptor to be set on the model returned in the
decode method. |
String |
getDecodeFileName()
Returns the name of the file to be decoded.
|
String |
getDisplayName()
Returns a short, displayable name for the format that is decoded by this
ILcdModelDecoder. |
protected void |
handleRecord(int aFormat,
char[] aRecord)
Deals with one record of input.
|
void |
setAerodromeDefaultDisplayNameIndex(int aIndex)
Specifies the index of the feature to be used as
display name.
|
void |
setAerodromeFeaturesToBeDecoded(String[] aFeaturesToBeDecoded)
Specifies the names of the features that should be decoded into the aerodrome objects
of the model that will be returned by the
decode method. |
void |
setCollocatedAerodromeFeaturesToBeDecoded(String[] aCollocatedAerodromeFeaturesToBeDecoded)
Specifies the names of the features that should be decoded into the collocated aerodrome
objects of the model that will be returned by the
decode method. |
getTypeForChar, readCommunicationFeaturesFromType1, readCommunicationFeaturesFromType2, readCommunicationFeaturesFromType3, readCommunicationRemark, readCommunicationRemarkSequenceNumber, readCommunicationType, readCommunicationTypeMultiplierFromType1, readCommunicationTypeMultiplierFromType2, readCommunicationTypeMultiplierFromType3, readCommunicationTypeMultiplierFromType4, readCountryCodeFromFmt1, readElevationFromFmt1, readFAAHostCountryIdentifierFromFmt1, readGeodeticLat, readGeodeticLon, readICAOCodeFromFmt1, readIdentification, readLat, readLocalHorizontalDatumFromFmt1, readLon, readMagneticVariation, readNameFromFmt1, readOperationsTypeFromFmt1, readRotatingBeaconFromFmt1, readStateProvinceCodeFromFmt1, readWACFromFmt1, setCommunicationFeaturesToBeDecoded, splitAerodromeFeaturescleanUp, decode, setKeyFeatureNamesaddErrorReport, canDecodeSource, getAltitudeType, getBearingTypeForChar, getBounds, getDAFIFProperties, getDataObjectFactory, getDecodingBounds, getDomainFactory, getErrorMessage, getInputStream, getInputStreamFactory, getLocalHorizontalDatum, getModelFilter, getRecordCount, initializeErrorMessage, isStoreOriginalReference, isTraceOn, loadCFGProperties, read, readExactValue, readFormat, readMinLength, readRecord, setBounds, setDAFIFModelFilter, setDAFIFProperties, setDataObjectFactory, setDecodingBounds, setDomainFactory, setInputStreamFactory, setStoreOriginalReference, setTraceOn, transformPointToReferenceDatumSFCTclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitcanDecodeSource, decodeModelMetadata, decodeModelMetadata, decodeSource, discoverDataSources@Deprecated public TLcdDAFIFAerodromeDecoder(ALcdAISObjectFactory aFactory)
TLcdDAFIFAerodromeDecoder object. The user
should specify which domainFactory he or she wants to use to create the aerodromes.aFactory - the factory to be used to create the aerodromespublic TLcdDAFIFAerodromeDecoder(TLcdAISDataObjectFactory aFactory)
TLcdDAFIFAerodromeDecoder object. The user
should specify which data object factory he or she wants to use to create the aerodromes.aFactory - the factory to be used to create the aerodromes@Deprecated public TLcdDAFIFAerodromeDecoder(ALcdAISObjectFactory aFactory, Properties aDAFIFProperties)
TLcdDAFIFAerodromeDecoder object.aFactory - the factory to be used to create the aerodromesaDAFIFProperties - a Properties object that contains for each domain object
the associated file namepublic TLcdDAFIFAerodromeDecoder(TLcdAISDataObjectFactory aFactory, Properties aDAFIFProperties)
TLcdDAFIFAerodromeDecoder object.aFactory - the factory to be used to create the aerodromesaDAFIFProperties - a Properties object that contains for each domain object
the associated file namepublic String getDisplayName()
ILcdModelDecoderILcdModelDecoder.getDisplayName in interface ILcdModelDecodergetDisplayName in class ALcdDAFIFDecoderILcdModelDecoder.public String getDecodeFileName()
ILcdDAFIFDecoderEach domain object has its own file name. This method returns the name of the data file for the domain objects decoded by this DAFIF decoder.
protected final void handleRecord(int aFormat,
char[] aRecord)
ALcdDAFIFSingleModelDecoderhandleRecord in class ALcdDAFIFSingleModelDecoderaFormat - the format of the recordaRecord - the recordprotected ILcdModelDescriptor createModelDescriptor(String aSource)
ALcdDAFIFSingleModelDecoderdecode method.createModelDescriptor in class ALcdDAFIFSingleModelDecoderaSource - the source that will be used to decodepublic void setAerodromeDefaultDisplayNameIndex(int aIndex)
aIndex - the index of the feature to be used as display namepublic void setAerodromeFeaturesToBeDecoded(String[] aFeaturesToBeDecoded)
decode method.
Note:
Please make sure that the IDENTIFICATION feature
is in your list.
aFeaturesToBeDecoded - a list of features that should be decoded into the aerodrome objectspublic void setCollocatedAerodromeFeaturesToBeDecoded(String[] aCollocatedAerodromeFeaturesToBeDecoded)
decode method.aCollocatedAerodromeFeaturesToBeDecoded - a list of features that should be decoded into the collocated aerodrome
objects