org.deegree.model.coverage.grid
Class GridCoverageExchange

java.lang.Object
  org.deegree.model.coverage.grid.GridCoverageExchange

public class GridCoverageExchange
extends Object

Support for creation of grid coverages from persistent formats as well as exporting a grid coverage to a persistent formats. For example, it allows for creation of grid coverages from the GeoTIFF Well-known binary format and exporting to the GeoTIFF file format. Basic implementations only require creation of grid coverages from a file format or resource. More sophesticated implementations may extract the grid coverages from a database. In such case, a GridCoverageExchange instance will hold a connection to a specific database and the #dispose method will need to be invoked in order to close this connection.

Since:

2.0

Version:

1.0

Author:

Andreas Poth

Nested Class Summary

(package private) class

GridCoverageExchange.DFileFilter class: official version of a FilenameFilter

Field Summary

static String	SHAPE_DIR_NAME
static String	SHAPE_IMAGE_FILENAME

Constructor Summary

GridCoverageExchange(CoverageOffering coverageOffering)

Method Summary

GridCoverageReader	getReader(InputStream source, CoverageOffering description, Envelope envelope, Format format) This method is a deegree specific enhancement of the GridCoverageExchange class/interface as defined by GeoAPI.
GridCoverageReader	getReader(Object source) Returns a grid coverage reader that can manage the specified source
GridCoverageReader	getReader(Object[] resources, CoverageOffering description, Envelope envelope, Format format) This method is a deegree specific enhancement of the GridCoverageExchange class/interface as defined by GeoAPI.
GridCoverageReader	getReader(Object resource, CoverageOffering description, Envelope envelope, Format format) This method is a deegree specific enhancement of the GridCoverageExchange class/interface as defined by GeoAPI.
GridCoverageWriter	getWriter(Object destination, Format format) Returns a GridCoverageWriter that can write the specified format.

Methods inherited from class java.lang.Object

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

Field Detail

SHAPE_IMAGE_FILENAME

public static final String SHAPE_IMAGE_FILENAME

See Also:

Constant Field Values

SHAPE_DIR_NAME

public static final String SHAPE_DIR_NAME

See Also:

Constant Field Values

Constructor Detail

GridCoverageExchange

public GridCoverageExchange(CoverageOffering coverageOffering)

Parameters:

formats -

Method Detail

getReader

public GridCoverageReader getReader(Object source)
                             throws IOException

Returns a grid coverage reader that can manage the specified source

Parameters:

source - An object that specifies somehow the data source. Can be a String, an InputStream, a FileChannel, whatever. It's up to the associated grid coverage reader to make meaningful use of it.

Returns:

The grid coverage reader.

Throws:

IOException - if an error occurs during reading.

revisit

We need a mechanism to allow the right GridCoverageReader Something like an SPI. What if we can't find a GridCoverageReader? Do we return null or throw an Exception?

getReader

public GridCoverageReader getReader(InputStream source,
                                    CoverageOffering description,
                                    Envelope envelope,
                                    Format format)
                             throws IOException

This method is a deegree specific enhancement of the GridCoverageExchange class/interface as defined by GeoAPI. Returns a grid coverage reader that can manage the specified source

Parameters:

source - An object that specifies somehow the data source.

description - an object describing the grid coverage and the access to avaiable metadata

envelope -

format -

Returns:

The grid coverage reader.

Throws:

IOException - if an error occurs during reading.

revisit

We need a mechanism to allow the right GridCoverageReader Something like an SPI. What if we can't find a GridCoverageReader? Do we return null or throw an Exception?

getReader

public GridCoverageReader getReader(Object resource,
                                    CoverageOffering description,
                                    Envelope envelope,
                                    Format format)
                             throws IOException,
                                    InvalidParameterValueException

This method is a deegree specific enhancement of the GridCoverageExchange class/interface as defined by GeoAPI. Returns a grid coverage reader that can manage the specified source

Parameters:

resource - a string that specifies somehow the data source (e.g. a file).

description - an object describing the grid coverage and the access to avaiable metadata

envelope -

format -

Returns:

The grid coverage reader.

Throws:

IOException - if an error occurs during reading.

InvalidParameterValueException

revisit

We need a mechanism to allow the right GridCoverageReader Something like an SPI. What if we can't find a GridCoverageReader? Do we return null or throw an Exception?

getReader

public GridCoverageReader getReader(Object[] resources,
                                    CoverageOffering description,
                                    Envelope envelope,
                                    Format format)
                             throws IOException,
                                    InvalidParameterValueException

This method is a deegree specific enhancement of the GridCoverageExchange class/interface as defined by GeoAPI. Returns a grid coverage reader that can manage the specified source

Parameters:

resources - an array strings that specifies somehow the data sources (e.g. some files).

description - an object describing the grid coverage and the access to avaiable metadata

envelope -

Returns:

The grid coverage reader.

Throws:

IOException - if an error occurs during reading.

InvalidParameterValueException

revisit

We need a mechanism to allow the right GridCoverageReader Something like an SPI. What if we can't find a GridCoverageReader? Do we return null or throw an Exception?

getWriter

public GridCoverageWriter getWriter(Object destination,
                                    Format format)
                             throws IOException

Returns a GridCoverageWriter that can write the specified format. The file format name is determined from the Format interface. Sample file formats include:

"GeoTIFF"	- GeoTIFF
"PIX"	- PCI Geomatics PIX
"HDF-EOS"	- NASA HDF-EOS
"NITF"	- National Image Transfer Format
"STDS-DEM"	- Standard Transfer Data Standard

Parameters:

destination - An object that specifies somehow the data destination. Can be a String, an OutputStream, a FileChannel, whatever. It's up to the associated grid coverage writer to make meaningful use of it.

format - the output format.

Returns:

The grid coverage writer.

Throws:

IOException - if an error occurs during reading.