public class TLcdARINCHeliportCommunicationHandler extends Object
ALcdARINCHandler
interface deals
with heliport communication records (Heliport Communications Records, section code H, subsection code V).
Decoded models have as model descriptor an instance of TLcdARINCHeliportCommunicationModelDescriptor
.
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 type of the decoded objects is TLcdARINCDataTypes.AerodromeCommunication
,
which can also be retrieved through ILcdDataObject.getDataType()
.
The available properties of the objects are defined in TLcdARINCAerodromeCommunicationDataProperties
.
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 setCommunicationFeatureNamesToBeDecoded(String[])
setCommunicationFeatureNamesToBeDecoded} method
allows the user to specify which ARINC features are decoded into the featured model objects.
If no feature names to be decoded are specified, all features will be decoded.
The following fields (taken from the ARINC specification 424) are supported by the decoder. The list indicates into which feature the fields are decoded. It also indicates from which ARINC version on they are available.
setAerodromeModel(com.luciad.model.ILcdModel)
, setDMEModel(com.luciad.model.ILcdModel)
, setVORModel(com.luciad.model.ILcdModel)
,
setNDBModel(com.luciad.model.ILcdModel)
, setTACANModel(com.luciad.model.ILcdModel)
)
from which the sector facilities can be retrieved.setAerodromeModel(com.luciad.model.ILcdModel)
, setDMEModel(com.luciad.model.ILcdModel)
, setVORModel(com.luciad.model.ILcdModel)
,
setNDBModel(com.luciad.model.ILcdModel)
, setTACANModel(com.luciad.model.ILcdModel)
)
from which the remote facilities can be retrieved.ARINC handlers 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 heliport communications the key features are:
ILcdARINCAerodromeCommunicationFeature.AERODROME_IDENTIFIER
ILcdARINCAerodromeCommunicationFeature.ICAO_CODE
ILcdARINCCommunicationFeature.COMMUNICATION_TYPE
ILcdARINCCommunicationFeature.COMMUNICATION_FREQUENCY
ILcdARINCCommunicationFeature.COMMUNICATION_FREQUENCY_UNIT
ILcdARINCCommunicationFeature.GUARD_TRANSMIT
TLcdARINCHeliportCommunicationModelDescriptor
Constructor and Description |
---|
TLcdARINCHeliportCommunicationHandler()
Constructs a new
TLcdARINCHeliportCommunicationHandler object. |
Modifier and Type | Method and Description |
---|---|
ILcdBounds |
getBoundsToFilterOn()
Returns the (geodetic) bounds that will be used as a filter on the model
created by this handler.
|
String[] |
getCommunicationFeatureNamesToBeDecoded()
Returns the features that will be stored in the domain objects created by this handler.
|
TLcdAISDataObjectFactory |
getDataObjectFactory()
Returns the factory to be used to
create domain objects.
|
ALcdAISObjectFactory |
getDomainFactory()
Deprecated.
|
ILcdBounds |
getInitialBounds()
Returns the bounds to be used as initial bounds for the model created by this handler.
|
protected ILcdGeodeticDatum |
getLocalHorizontalDatum(String aGeodeticDatumCode)
Returns an instance of an implementation of the
ILcdGeodeticDatum interface
according to the given geodetic datum code. |
ILcdFeatureIndexedAnd2DBoundsIndexedModel |
getModel()
Returns the model build by this handler.
|
void |
handleRecord(char[] aRecord)
Deals with one record of ARINC data.
|
boolean |
isStoreOriginalReference()
If true, the decoder will store the original geodetic datum of each domain
object in a feature.
|
boolean |
isTraceOn()
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.
|
void |
newModel(String aSource,
ILcdARINCErrorMessageSupport aErrorMessage)
Resets the internal state of this handler so that
it is ready to handle a new data source from scratch.
|
protected String |
read(char[] aRecord,
int aStart,
int aLength)
Reads from aRecord from position aStart to aStart + aLength - 1, trims the
resulting
String object and returns it. |
protected char |
readSectionCode(char[] aRecord)
Reads the section code of an ARINC record.
|
void |
setAerodromeModel(ILcdModel aAerodromeModel)
Specifies a model of aerodromes that is used to retrieve sector or remote facilities.
|
void |
setARINCModelFilter(ILcdARINCModelFilter aFilter)
Specifies a filter to be used while creating the model.
|
void |
setBoundsToFilterOn(ILcdBounds aBoundsToFilterOn)
Specifies (geodetic) bounds that will be used as a filter on the model
created by this handler.
|
static void |
setClassTraceOn(boolean aTraceOn)
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.
|
void |
setCommunicationFeatureNamesToBeDecoded(String[] aFeatureNamesToBeDecoded)
Specifies which features should be stored in the domain objects created by this handler.
|
void |
setDataObjectFactory(TLcdAISDataObjectFactory aFactory)
Specifies the factory to be used to
create domain objects.
|
void |
setDefaultGeodeticDatum(ILcdGeodeticDatum aDefaultGeodeticDatum)
Sets the default geodetic datum code.
|
void |
setDMEModel(ILcdModel aDMEModel)
Specifies a model of DMEs that is used to retrieve sector or remote facilities.
|
void |
setDomainFactory(ALcdAISObjectFactory aDomainFactory)
Deprecated.
|
void |
setInitialBounds(ILcdBounds aInitialBounds)
Specifies a bounds to be used as initial bounds for the model created by this handler.
|
void |
setNDBModel(ILcdModel aNDBModel)
Specifies a model of NDBs that is used to retrieve sector or remote facilities.
|
void |
setStoreOriginalReference(boolean aStoreRef)
If true, the decoder will store the original geodetic datum of each domain
object in a feature.
|
void |
setTACANModel(ILcdModel aTACANModel)
Specifies a model of TACANs that is used to retrieve sector or remote facilities.
|
void |
setTraceOn(boolean aTraceOn)
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.
|
void |
setVORModel(ILcdModel aVORModel)
Specifies a model of VORs that is used to retrieve sector or remote facilities.
|
public TLcdARINCHeliportCommunicationHandler()
TLcdARINCHeliportCommunicationHandler
object.public void handleRecord(char[] aRecord)
ILcdARINCHandler
Each implementation of the ILcdARINCHandler
interface decides by itself whether to use the information
found in the given record to
create or modify a domain object, or to do nothing at all.
Typically, this method will be called when looping through the records of a data source.
The domain objects created or modified when calling this method
will be stored in a model. The user can obtain this model by
calling the getModel
method.
handleRecord
in interface ILcdARINCHandler
aRecord
- the record to deal with
created with data from the given record inILcdARINCHandler.getModel()
public String[] getCommunicationFeatureNamesToBeDecoded()
setCommunicationFeatureNamesToBeDecoded(java.lang.String[])
public void setCommunicationFeatureNamesToBeDecoded(String[] aFeatureNamesToBeDecoded)
aFeatureNamesToBeDecoded
- an array containing the names of the features to be stored in the domain objects
created by this handler.
Feature names should be taken from the
ILcdARINCAerodromeCommunicationFeature
interface.getCommunicationFeatureNamesToBeDecoded()
public void setAerodromeModel(ILcdModel aAerodromeModel)
ILcdARINCAerodromeCommunicationFeature.REMOTE_FACILITY
or ILcdARINCAerodromeCommunicationFeature.SECTOR_FACILITY
are decoded
(see setCommunicationFeatureNamesToBeDecoded(String[])
setCommunicationFeatureNamesToBeDecoded} method).aAerodromeModel
- the aerodrome model to retrieve sector facilities.public void setNDBModel(ILcdModel aNDBModel)
ILcdARINCAerodromeCommunicationFeature.REMOTE_FACILITY
or ILcdARINCAerodromeCommunicationFeature.SECTOR_FACILITY
are decoded
(see setCommunicationFeatureNamesToBeDecoded(String[])
setCommunicationFeatureNamesToBeDecoded} method).aNDBModel
- the NDB model to retrieve sector or remote facilities.public void setDMEModel(ILcdModel aDMEModel)
ILcdARINCAerodromeCommunicationFeature.REMOTE_FACILITY
or ILcdARINCAerodromeCommunicationFeature.SECTOR_FACILITY
are decoded
(see setCommunicationFeatureNamesToBeDecoded(String[])
setCommunicationFeatureNamesToBeDecoded} method).aDMEModel
- the DME model to retrieve sector or remote facilities.public void setTACANModel(ILcdModel aTACANModel)
ILcdARINCAerodromeCommunicationFeature.REMOTE_FACILITY
or ILcdARINCAerodromeCommunicationFeature.SECTOR_FACILITY
are decoded
(see setCommunicationFeatureNamesToBeDecoded(String[])
setCommunicationFeatureNamesToBeDecoded} method).aTACANModel
- the TACAN model to retrieve sector or remote facilities.public void setVORModel(ILcdModel aVORModel)
ILcdARINCAerodromeCommunicationFeature.REMOTE_FACILITY
or ILcdARINCAerodromeCommunicationFeature.SECTOR_FACILITY
are decoded
(see setCommunicationFeatureNamesToBeDecoded(String[])
setCommunicationFeatureNamesToBeDecoded} method).aVORModel
- the VOR model to retrieve sector or remote facilities.@Deprecated public void setDomainFactory(ALcdAISObjectFactory aDomainFactory)
ILcdARINCHandler
The given domainFactory must not be null.
setDomainFactory
in interface ILcdARINCHandler
aDomainFactory
- the domainFactory to be used to
create domain objectsILcdARINCHandler.getDomainFactory()
@Deprecated public ALcdAISObjectFactory getDomainFactory()
ILcdARINCHandler
getDomainFactory
in interface ILcdARINCHandler
ILcdARINCHandler.setDomainFactory(com.luciad.ais.model.ALcdAISObjectFactory)
public void setDataObjectFactory(TLcdAISDataObjectFactory aFactory)
ILcdARINCHandler
The given factory must not be null.
setDataObjectFactory
in interface ILcdARINCHandler
aFactory
- the domainFactory to be used to
create domain objectsILcdARINCHandler.getDataObjectFactory()
public TLcdAISDataObjectFactory getDataObjectFactory()
ILcdARINCHandler
getDataObjectFactory
in interface ILcdARINCHandler
ILcdARINCHandler.setDataObjectFactory(TLcdAISDataObjectFactory)
public void setDefaultGeodeticDatum(ILcdGeodeticDatum aDefaultGeodeticDatum)
null
can also be provided:
in that case, records which do not mention a geodetic datum will be ignored.aDefaultGeodeticDatum
- The default geodetic datum.public ILcdFeatureIndexedAnd2DBoundsIndexedModel getModel()
ILcdARINCHandler
Please remark that this handler is only capable of creating the expected model if the user calls
newModel
method to reset the internal
state before he or she starts the decoding process,handleRecord
method each time a new
record in the data source is accessed.getModel
in interface ILcdARINCHandler
public void setBoundsToFilterOn(ILcdBounds aBoundsToFilterOn)
ILcdARINCHandler
If this bounds is null, all objects found in the data source will be inserted into the model. If this bounds is not null, only the objects whose bounds interact with the specified bounds will be inserted into the model.
setBoundsToFilterOn
in interface ILcdARINCHandler
aBoundsToFilterOn
- the bounds to be used as a filterpublic ILcdBounds getBoundsToFilterOn()
ILcdARINCHandler
getBoundsToFilterOn
in interface ILcdARINCHandler
ILcdARINCHandler.setBoundsToFilterOn(com.luciad.shape.ILcdBounds)
public void setInitialBounds(ILcdBounds aInitialBounds)
ILcdARINCHandler
This bounds should be large enough to enclose (most of) the model objects. This option is used to avoid to many expansions of the model bounds.
This parameter may be null.
Note: This bounds is not a filter! If a model objects bounds does not interact with aInitialBounds, aInitialBounds will be enlarged to enclose the object.
setInitialBounds
in interface ILcdARINCHandler
aInitialBounds
- the initial bounds for the model created by this handlerpublic ILcdBounds getInitialBounds()
ILcdARINCHandler
getInitialBounds
in interface ILcdARINCHandler
ILcdARINCHandler.setInitialBounds(com.luciad.shape.ILcdBounds)
public void newModel(String aSource, ILcdARINCErrorMessageSupport aErrorMessage)
ILcdARINCHandler
The user should call this method before using this handler in a decoding process.
newModel
in interface ILcdARINCHandler
aSource
- the name of the source that will be handledaErrorMessage
- for each irregular situation during the decoding, a report should be
added to this objectpublic void setARINCModelFilter(ILcdARINCModelFilter aFilter)
ILcdARINCHandler
setARINCModelFilter
in interface ILcdARINCHandler
aFilter
- an ILcdARINCModelFilter
to filter the model objectspublic boolean isTraceOn()
true
if tracing is enabled for this class.public static void setClassTraceOn(boolean aTraceOn)
true
then all log messages are recorded, otherwise only
the informative, warning and error messages are recorded.aTraceOn
- if true then all log messages are recorded,
otherwise only the informative, warning and error messages are recorded.public void setTraceOn(boolean aTraceOn)
true
or false
as argument automatically turns
off tracing for all other class instances for which
setTraceOn
has not been called.
If the argument is false
then only the informative, warning
and error log messages are recorded.aTraceOn
- if true then all log messages are recorded for this
instance. If false, then only the informative, warning and
error log messages are recorded.protected char readSectionCode(char[] aRecord)
aRecord
- the record to read ofprotected String read(char[] aRecord, int aStart, int aLength)
String
object and returns it.aRecord
- the record to be read ofaStart
- the start position for readingaLength
- the length of the String
to be readString
objectprotected ILcdGeodeticDatum getLocalHorizontalDatum(String aGeodeticDatumCode)
ILcdGeodeticDatum
interface
according to the given geodetic datum code. The datum code is expected to be specified by
their three character representation, as it is used in the ARINC specification.
The full list of supported geodetic datum codes can be found in the ARINC Developer's Guide.
If the supplied code is null or empty, the default geodetic datum is returned.
This is WGS 84 by default, but it can be configured through setDefaultGeodeticDatum
.
If no geodetic datum can be found, null
is returned.aGeodeticDatumCode
- the code for the geodetic datum to be returnedpublic void setStoreOriginalReference(boolean aStoreRef)
ILcdARINCHandler
setStoreOriginalReference
in interface ILcdARINCHandler
aStoreRef
- specifies if the decoder must store the original geodetic datum
of each domain object in a feature.public boolean isStoreOriginalReference()
ILcdARINCHandler
isStoreOriginalReference
in interface ILcdARINCHandler