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, fCommunicationFeaturesType4
DAFIF_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, splitAerodromeFeatures
cleanUp, decode, setKeyFeatureNames
addErrorReport, 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, transformPointToReferenceDatumSFCT
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
canDecodeSource, 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()
ILcdModelDecoder
ILcdModelDecoder
.getDisplayName
in interface ILcdModelDecoder
getDisplayName
in class ALcdDAFIFDecoder
ILcdModelDecoder
.public String getDecodeFileName()
ILcdDAFIFDecoder
Each 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)
ALcdDAFIFSingleModelDecoder
handleRecord
in class ALcdDAFIFSingleModelDecoder
aFormat
- the format of the recordaRecord
- the recordprotected ILcdModelDescriptor createModelDescriptor(String aSource)
ALcdDAFIFSingleModelDecoder
decode
method.createModelDescriptor
in class ALcdDAFIFSingleModelDecoder
aSource
- 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