com.luciad.format.asterix

Radar ConnectorsClass ALcdASTERIXDecoder

java.lang.Object

com.luciad.format.asterix.ALcdASTERIXDecoder

Direct Known Subclasses:

TLcdASTERIXLiveDecoder, TLcdASTERIXLiveModelDecoder, TLcdASTERIXModelDecoder

public abstract class ALcdASTERIXDecoder
extends Object

Base class for both ASTERIX decoders: TLcdASTERIXLiveDecoder and TLcdASTERIXModelDecoder. ASTERIX is the Eurocontrol standard for exchanging ATM surveillance data. Surveillance data is classified into data categories. More information on the ASTERIX standard and defined categories can be obtained from the Eurocontrol website. To learn which data categories are supported, please browse the subclasses of ALcdASTERIXCategory.

This base class contains the common part between the two actual decoders, and allows to:

• Limit the data categories that are parsed, see setCategories(ALcdASTERIXCategory[]). Note that future versions of the Radar Connectors component might include additional supported data categories. Therefore upgrading to a new version might cause data to be parsed that was not parsed before. If one is only interested in one or more particular data categories, it is advised to set those on the decoder using setCategories(ALcdASTERIXCategory[]).
• Specify the transformation provider, see setTransformationProvider(ALcdASTERIXTransformationProvider).
• Specify the scaling factor provider, see setScalingFactorProvider(ALcdASTERIXScalingFactorProvider).
• Specify the reference provider, see setReferenceProvider(ALcdASTERIXReferenceProvider).
• Specify the record filter that decides which ASTERIX records to process and which to ignore, see setRecordFilter(ILcdASTERIXRecordFilter).

Method Summary

Modifier and Type	Method and Description
ALcdASTERIXCategory[]	getCategories() Returns the ASTERIX data categories handled by this decoder.
ILcdASTERIXRecordFilter	getRecordFilter() Returns the record filter.
ALcdASTERIXReferenceProvider	getReferenceProvider() Returns the current ALcdASTERIXReferenceProvider.
ALcdASTERIXScalingFactorProvider	getScalingFactorProvider() Returns the current ALcdASTERIXScalingFactorProvider.
ALcdASTERIXTransformationProvider	getTransformationProvider() Returns the current ALcdASTERIXTransformationProvider.
static boolean	isClassTraceOn() Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.
void	setCategories(ALcdASTERIXCategory[] aCategories) Sets the ASTERIX data categories this decoder will handle.
static void	setClassTraceOn(boolean aClassTraceOn) Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.
void	setRecordFilter(ILcdASTERIXRecordFilter aRecordFilter) Sets the record filter that will decide for each individual ASTERIX record whether it is processed or ignored.
void	setReferenceProvider(ALcdASTERIXReferenceProvider aReferenceProvider) Sets a new ALcdASTERIXReferenceProvider on this decoder.
void	setScalingFactorProvider(ALcdASTERIXScalingFactorProvider aScalingFactorProvider) Sets a new ALcdASTERIXScalingFactorProvider on this decoder.
void	setTransformationProvider(ALcdASTERIXTransformationProvider aTransformationProvider) Sets a new ALcdASTERIXTransformationProvider on this decoder.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setClassTraceOn

public static void setClassTraceOn(boolean aClassTraceOn)

Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Enables tracing for all instances of this class. If the argument is true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

Parameters:

aClassTraceOn - if true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

isClassTraceOn

public static boolean isClassTraceOn()

Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Returns true if tracing is enabled for this class.

Returns:

true if tracing is enabled for this class, false otherwise.

getTransformationProvider

public ALcdASTERIXTransformationProvider getTransformationProvider()

Returns the current ALcdASTERIXTransformationProvider.

Returns:

The ALcdASTERIXTransformationProvider used during decoding.

setTransformationProvider

public void setTransformationProvider(ALcdASTERIXTransformationProvider aTransformationProvider)

Sets a new ALcdASTERIXTransformationProvider on this decoder.

Parameters:

aTransformationProvider - This new ALcdASTERIXTransformationProvider will be used for future decodes.

getScalingFactorProvider

public ALcdASTERIXScalingFactorProvider getScalingFactorProvider()

Returns the current ALcdASTERIXScalingFactorProvider.

Returns:

The ALcdASTERIXScalingFactorProvider used during decoding.

setScalingFactorProvider

public void setScalingFactorProvider(ALcdASTERIXScalingFactorProvider aScalingFactorProvider)

Sets a new ALcdASTERIXScalingFactorProvider on this decoder.

Parameters:

aScalingFactorProvider - This new ALcdASTERIXScalingFactorProvider will be used for future decodes.

getReferenceProvider

public ALcdASTERIXReferenceProvider getReferenceProvider()

Returns the current ALcdASTERIXReferenceProvider.

Returns:

the model reference provider used during decoding

setReferenceProvider

public void setReferenceProvider(ALcdASTERIXReferenceProvider aReferenceProvider)

Sets a new ALcdASTERIXReferenceProvider on this decoder.

Parameters:

aReferenceProvider - the model reference provider used during decoding

getCategories

public ALcdASTERIXCategory[] getCategories()

Returns the ASTERIX data categories handled by this decoder.

Returns:

the ASTERIX data categories handled by this decoder.

See Also:

setCategories(com.luciad.format.asterix.ALcdASTERIXCategory[])

setCategories

public void setCategories(ALcdASTERIXCategory[] aCategories)

Sets the ASTERIX data categories this decoder will handle. It allows to limit the categories that are processed to a well defined subset.

Note that ALcdASTERIXCategory instances must not be shared between different instances of ALcdASTERIXDecoder.

Parameters:

aCategories - The categories to handle.

See Also:

getCategories()

getRecordFilter

public ILcdASTERIXRecordFilter getRecordFilter()

Returns the record filter. The filter set by default accepts all records.

Returns:

The record filter. Never null.

See Also:

setRecordFilter(ILcdASTERIXRecordFilter)

setRecordFilter

public void setRecordFilter(ILcdASTERIXRecordFilter aRecordFilter)

Sets the record filter that will decide for each individual ASTERIX record whether it is processed or ignored.

Parameters:

aRecordFilter - The record filter. Must not be null.