com.luciad.reference.format

LuciadFusionClass TLcdWKTModelReferenceDecoder

java.lang.Object

com.luciad.reference.format.TLcdWKTModelReferenceDecoder

All Implemented Interfaces:

ILcdInputStreamFactoryCapable, ILcdModelReferenceDecoder

@LcdService(service=ILcdModelReferenceDecoder.class,
            priority=20000)
public class TLcdWKTModelReferenceDecoder
extends java.lang.Object
implements ILcdModelReferenceDecoder, ILcdInputStreamFactoryCapable

This decoder attempts to create a ILcdModelReference from a file in the directory of the given data source file aSource.

• If the file name aSource is <name>.xxx, it first tries to open a file called <name>.prj.
• If this file does not exist, it tries to open a file called directory.prj (this can be used as a common default file for all the data files in the same directory).
• It this file does not exist, a IOException is thrown..

The extension .prj and .PRJ is tried for case sensitive file systems.

See Also:

TLcdWKTReferenceParser, TLcdCompositeModelReferenceDecoder

Constructor Summary

Constructors

Constructor and Description
TLcdWKTModelReferenceDecoder()

Method Summary

Modifier and Type	Method and Description
ILcdModelReference	decodeModelReference(java.lang.String aSource) Returns the model reference, associated with the specified data source.
ILcdInputStreamFactory	getInputStreamFactory() Returns the input stream factory that is used.
void	setInputStreamFactory(ILcdInputStreamFactory aInputStreamFactory) Sets the input stream factory to be used.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdWKTModelReferenceDecoder

public TLcdWKTModelReferenceDecoder()

Method Detail

decodeModelReference

public ILcdModelReference decodeModelReference(java.lang.String aSource)
                                        throws java.io.IOException

Description copied from interface: ILcdModelReferenceDecoder

Returns the model reference, associated with the specified data source.

Specified by:

decodeModelReference in interface ILcdModelReferenceDecoder

Parameters:

aSource - a data source for which to return the model reference; typically a file name or a URL.

Returns:

the ILcdModelReference associated with the data source. While null is allowed, implementors are advised to throw an error instead.

Throws:

java.io.IOException - if the ILcdModelReference cannot be decoded. It is recommended to throw a FileNotFoundException when the source passed does not point to an existing file. This allows to differentiate between missing model reference files and corrupt model reference files.
When the thread on which this method is called is interrupted, it is recommended to stop the decoding and throw an InterruptedIOException. This same exception can also be used if the decoder shows UI to the user, and the user cancels the decoding through the UI.

setInputStreamFactory

public void setInputStreamFactory(ILcdInputStreamFactory aInputStreamFactory)

Description copied from interface: ILcdInputStreamFactoryCapable

Sets the input stream factory to be used.

Specified by:

setInputStreamFactory in interface ILcdInputStreamFactoryCapable

Parameters:

aInputStreamFactory - the input stream factory to be used.

getInputStreamFactory

public ILcdInputStreamFactory getInputStreamFactory()

Description copied from interface: ILcdInputStreamFactoryCapable

Returns the input stream factory that is used.

Specified by:

getInputStreamFactory in interface ILcdInputStreamFactoryCapable

Returns:

the input stream factory that is used.