com.luciad.reference.format

LuciadLightspeedClass TLcdEPSGModelReferenceDecoder

java.lang.Object

com.luciad.reference.format.TLcdEPSGModelReferenceDecoder

All Implemented Interfaces:

ILcdInputStreamFactoryCapable, ILcdModelReferenceDecoder

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

This ILcdModelReferenceDecoder decodes model references based on .epsg files corresponding to the given source files. A .epsg file contains a single decimal EPSG code, formatted as "n" or "EPSG:n", that defines a georeference. Any lines starting with a hash sign "#" are treated as comments and ignored.

The decoder first tries to find a .epsg file by replacing the extension of the source file by .epsg.

If this fails, it tries to find a directory.epsg file next to the source file.

If this fails, it tries to find a DIRECTORY.EPSG file next to the source file.

If this fails, it throws an IOException.

See TLcdEPSGReferenceParser for a list of supported epsg codes.

Since:

8.0

See Also:

TLcdEPSGReferenceParser, TLcdCompositeModelReferenceDecoder

Constructor Summary

Constructors

Constructor and Description
TLcdEPSGModelReferenceDecoder()

Method Summary

Modifier and Type	Method and Description
ILcdModelReference	decodeModelReference(java.lang.String aSource) Tries to locate the model reference file by replacing the suffix by '.epsg', or adding the suffix '.epsg' if there was no suffix looking for a 'directory.epsg' in the same directory, looking for a 'DIRECTORY.EPSG' in the same directory. If no such file is found, an IOException is thrown.
ILcdInputStreamFactory	getInputStreamFactory() Returns the input stream factory that is used for accessing .epsg files.
void	setInputStreamFactory(ILcdInputStreamFactory aInputStreamFactory) Sets the input stream factory that will be used for accessing .epsg files.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdEPSGModelReferenceDecoder

public TLcdEPSGModelReferenceDecoder()

Method Detail

setInputStreamFactory

public void setInputStreamFactory(ILcdInputStreamFactory aInputStreamFactory)

Sets the input stream factory that will be used for accessing .epsg files.

Specified by:

setInputStreamFactory in interface ILcdInputStreamFactoryCapable

Parameters:

aInputStreamFactory - the factory responsible to generate input streams from which the model references will be decoded.

See Also:

getInputStreamFactory()

getInputStreamFactory

public ILcdInputStreamFactory getInputStreamFactory()

Returns the input stream factory that is used for accessing .epsg files.

Specified by:

getInputStreamFactory in interface ILcdInputStreamFactoryCapable

Returns:

the factory responsible to generate input streams from which the model references are decoded.

See Also:

setInputStreamFactory(ILcdInputStreamFactory)

decodeModelReference

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

Tries to locate the model reference file by

1. replacing the suffix by '.epsg', or adding the suffix '.epsg' if there was no suffix
2. looking for a 'directory.epsg' in the same directory,
3. looking for a 'DIRECTORY.EPSG' in the same directory.

If no such file is found, an IOException is thrown.

Specified by:

decodeModelReference in interface ILcdModelReferenceDecoder

Parameters:

aSource - the location of the data file for which to locate and decode a reference file.

Returns:

an ILcdModelReference decoded from one of the files as described above.

Throws:

java.io.IOException - if none of the files as described above exists, or when the file found cannot be decoded as a properties file.