com.luciad.ogc.wcs.client

LuciadLightspeedClass ALcdWCSCoverageDecoder

java.lang.Object

com.luciad.ogc.wcs.client.ALcdWCSCoverageDecoder

Direct Known Subclasses:

TLcdGeoTIFFWCSCoverageDecoder

public abstract class ALcdWCSCoverageDecoder
extends Object

A decoder for WCS GetCoverage responses which decodes a response as an ILcdModel which contains a single ALcdBasicImage, ALcdMultilevelImage, ALcdImageMosaic or ALcdMultilevelImageMosaic. A typical implementation should rely on ILcdModelDecoder.

Example for GeoTIFF:

 // Create an input stream factory for the decoder
 ILcdInputStreamFactory inputStreamFactory = new ILcdInputStreamFactory() {
  public InputStream createInputStream(String aSource) throws IOException {
    return new FilterInputStream(aContent) {
      public void close() {
        // Do nothing. It's not our responsibility to close the input stream.
      }
    };
  }
 };
 TLcdGeoTIFFModelDecoder decoder = new TLcdGeoTIFFModelDecoder();
 decoder.setInputStreamFactory(inputStreamFactory);
 return decoder.decode("Anonymous");
   

Since:

2015.1

Constructor Summary

Constructors

Constructor and Description
ALcdWCSCoverageDecoder()

Method Summary

Modifier and Type	Method and Description
abstract boolean	canDecodeCoverage(String aOutputFormat) Checks whether or not this decoder can decode a GetCoverage response in the given output format.
abstract ILcdModel	decodeCoverage(String aOutputFormat, String aContentType, InputStream aContent, TLcdWCSGetCoverageRequest aRequest) Decodes a GetCoverage response as an ILcdModel.

Methods inherited from class java.lang.Object

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

Constructor Detail

ALcdWCSCoverageDecoder

public ALcdWCSCoverageDecoder()

Method Detail

canDecodeCoverage

public abstract boolean canDecodeCoverage(String aOutputFormat)

Checks whether or not this decoder can decode a GetCoverage response in the given output format. The check must be quick and may be optimistic: implementations must return true when they probably can decode a response in the given output format. When they return false, they most definitely can't decode the given output format. 'true' has the semantics of 'probably', while 'false' really means 'no'. When this method returns true, a subsequent invocation of decodeCoverage(java.lang.String, java.lang.String, java.io.InputStream, com.luciad.ogc.wcs.client.TLcdWCSGetCoverageRequest) may yet throw an IOException to indicate that this decoder couldn't decode the coverage response after all.

Parameters:

aOutputFormat - the requested output format, never null.

Returns:

true if this decoder can probably decode a GetCoverage response in the given output format, false when it most definitely can't.

decodeCoverage

public abstract ILcdModel decodeCoverage(String aOutputFormat,
                                         String aContentType,
                                         InputStream aContent,
                                         TLcdWCSGetCoverageRequest aRequest)
                                  throws IOException

Decodes a GetCoverage response as an ILcdModel. The model must support the imaging API, which means that it should either contain an element which is or has an ALcdImage.

An element is an ALcdImage if it is an ALcdBasicImage, ALcdMultilevelImage, ALcdImageMosaic or ALcdMultilevelImageMosaic.

An element has an ALcdImage if it is an ILcdDataObject with an ALcdImage as geometry property, as defined by a data type with a TLcdHasGeometryAnnotation in its data model.

If the model has multiple elements, only the first one will be considered. If the element is or has a ALcdMultilevelImageMosaic, only the first level will be cosid

Parameters:

aOutputFormat - the requested output format, never null

aContentType - the content type (MIME type) of the GetCoverage response, possibly null

aContent - the GetCoverage response content as a stream, never null

aRequest - the request, never null

Returns:

the decoded coverage response as a model which contains an ALcdBasicImage, ALcdMultilevelImage, ALcdImageMosaic or ALcdMultilevelImageMosaic

Throws:

IOException - if this decoder couldn't decode the content