com.luciad.format.dafift.decoder

Aviation StandardsClass TLcdDAFIFTIndependentILSDecoder

java.lang.Object

com.luciad.format.dafift.decoder.ALcdDAFIFTModelDecoder

com.luciad.format.dafift.decoder.TLcdDAFIFTILSDecoder

com.luciad.format.dafift.decoder.TLcdDAFIFTIndependentILSDecoder

All Implemented Interfaces:

ILcdInputStreamFactoryCapable, ILcdModelDecoder

public class TLcdDAFIFTIndependentILSDecoder
extends TLcdDAFIFTILSDecoder

This extension of the TLcdDAFIFTILSDecoder class can be used to produce a model without having to specify a runway model first. The decoded models have as model descriptor an instance of TLcdDAFIFILSModelListDescriptor.

The TLcdDAFIFTIndependentILSDecoder will decode the runways himself. The runways whose directions will contain an ILS decoded by this decoder, will be retrieved from the resulting model.

To decode the runway model, the TLcdDAFIFTIndependentILSDecoder will look for a runway source file in the source directory to be decoded. If no runway source file is found in this directory, or the runway source file does not contain the runways needed to add the ILS objects, exceptions will occur during the decode process.

Since:

7.2

See Also:

TLcdDAFIFTILSDecoder

Constructor Summary

Constructors

Constructor and Description
TLcdDAFIFTIndependentILSDecoder(ALcdAISObjectFactory aDomainFactory) Deprecated.
TLcdDAFIFTIndependentILSDecoder(TLcdAISDataObjectFactory aDomainFactory) Creates a new TLcdDAFIFTIndependentILSDecoder object.

Method Summary

Modifier and Type	Method and Description
boolean	canDecodeSource(String aSource) Tests whether the canDecodeSource method of all decoders on which this decoder depends on, return true.
ILcdModel	decode(String aSource) Creates a runway model list before starting the decode process.
TLcdAISDataObjectFactory	getDataObjectFactory() Returns the factory that is used to create domain objects.
ALcdAISObjectFactory	getDomainFactory() Deprecated. Use getDataObjectFactory()
String	getErrorMessage() Returns the error message of the last decode call.
ILcdInputStreamFactory	getInputStreamFactory() Returns the input stream factory that is currently used for creating the input streams for the given source names.
int	getMaxNumberOfErrorReports() Returns the number of error reports to be added to the error message.
ILcdDAFIFTRecordFilter	getRecordFilter() Returns the record filter that is currently used.
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.
void	setDataObjectFactory(TLcdAISDataObjectFactory aFactory) Specifies the data factory.
void	setDomainFactory(ALcdAISObjectFactory aDomainFactory) Deprecated. Use setDataObjectFactory(TLcdAISDataObjectFactory)
void	setInputStreamFactory(ILcdInputStreamFactory aInputStreamFactory) Sets the input stream factory that will be used for creating the input streams for the given source names.
void	setMaxNumberOfErrorReports(int aMaxNumberOfErrorReports) Specifies a value for the maximum number of error reports.
void	setRecordFilter(ILcdDAFIFTRecordFilter aRecordFilter) Specifies a filter to be used while creating the model.

Methods inherited from class com.luciad.format.dafift.decoder.TLcdDAFIFTILSDecoder

getDisplayName, setDMEDefaultDisplayNameIndex, setDMEFeaturesToBeDecoded, setGlidePathDefaultDisplayNameIndex, setGlidePathFeaturesToBeDecoded, setLocalizerDefaultDisplayNameIndex, setLocalizerFeaturesToBeDecoded, setMarkerDefaultDisplayNameIndex, setMarkerFeaturesToBeDecoded, setRunwayModel

Methods inherited from class com.luciad.format.dafift.decoder.ALcdDAFIFTModelDecoder

getDecodingBounds, getModelFilter, setDecodingBounds, setModelFilter

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.model.ILcdModelDecoder

canDecodeSource, decodeModelMetadata, decodeModelMetadata, decodeSource, discoverDataSources

Constructor Detail

TLcdDAFIFTIndependentILSDecoder

@Deprecated
public TLcdDAFIFTIndependentILSDecoder(ALcdAISObjectFactory aDomainFactory)

Deprecated.

Creates a new TLcdDAFIFTIndependentILSDecoder object. The user should specify which aDomainFactory he or she wants to use to create the runways and the ILS patterns.

Parameters:

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

TLcdDAFIFTIndependentILSDecoder

public TLcdDAFIFTIndependentILSDecoder(TLcdAISDataObjectFactory aDomainFactory)

Creates a new TLcdDAFIFTIndependentILSDecoder object. The user should specify which aDomainFactory he or she wants to use to create the runways and the ILS patterns.

Parameters:

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

Method Detail

canDecodeSource

public boolean canDecodeSource(String aSource)

Tests whether the canDecodeSource method of all decoders on which this decoder depends on, return true.

Specified by:

canDecodeSource in interface ILcdModelDecoder

Parameters:

aSource - The name of the source file or directory that you want to decode.

Returns:

true if this decoder can decode the data specified by the source name, false otherwise.

See Also:

ILcdModelDecoder.decode(String), ILcdModelDecoder.decodeModelMetadata(String)

decode

public ILcdModel decode(String aSource)
                 throws IOException

Creates a runway model list before starting the decode process. This runway model list will be decoded using the specified source. After the runway model list is created, the decode method of the super class (TLcdDAFIFTILSDecoder.decode(String)) is called.

Specified by:

decode in interface ILcdModelDecoder

Overrides:

decode in class TLcdDAFIFTILSDecoder

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.

IllegalStateException - if no runway model could be created.

See Also:

ILcdModelDecoder.canDecodeSource(String)

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.

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(ALcdAISObjectFactory)

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:

getDomainFactory()

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:

setDomainFactory(ALcdAISObjectFactory)

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:

getDomainFactory()

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(ILcdInputStreamFactory)

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:

getInputStreamFactory()

getRecordFilter

public ILcdDAFIFTRecordFilter getRecordFilter()

Returns the record filter that is currently used.

Returns:

the record filter that is currently used.

See Also:

setRecordFilter(ILcdDAFIFTRecordFilter)

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:

getRecordFilter()

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(int)

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:

getMaxNumberOfErrorReports()

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.