org.nfis.gdas.v091
Class DataHandler

java.lang.Object
  org.nfis.gdas.v091.DataHandler

public class DataHandler
extends java.lang.Object

DataHandler assembles the return XML for a GDAS 0.9.1 GetData request defined in section 7.2 in the GDAS 0.9.1 specification.

This class is configured using an XML document defined by the dataHandlerConfig Schema . The 'dataset_config' element in this document must be configured for each Dataset (defined in GDAS 0.9.1 specification section 7.1.4.1.10) listed in the GDAS_Capabilities document. This configuration document tells the DataHandler which implementation of the DataRetrieverInterface to use for each Dataset when running the getData(String, String, String, String, String, String, String, String, OutputStream) method.

For more information see DataRetrieverInterface and the dataHandlerConfig.xsd

Version:

1.0 - Sep 17, 2004 - 12:26:54 PM

Author:

emurphy emurphy@pfc.cfs.nrcan.gc.ca

Constructor Summary

DataHandler(org.nfis.gdas.v091.GDASCapabilitiesDocument gDasCapabilitiesDoc, java.lang.String pathToDataHandlerConfigDoc)

Method Summary

void

getData(java.lang.String frameworkDomain, java.lang.String frameworkName, java.lang.String frameworkVersion, java.lang.String datasetDomain, java.lang.String datasetName, java.lang.String attributes, java.lang.String geoLinkIds, java.lang.String xsltUrl, java.io.OutputStream fileOut) Handle the GDAS GetData request.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataHandler

public DataHandler(org.nfis.gdas.v091.GDASCapabilitiesDocument gDasCapabilitiesDoc,
                   java.lang.String pathToDataHandlerConfigDoc)
            throws ServiceReportException

Parameters:

gDasCapabilitiesDoc - a validated 0.9.1 GetCapabilities document

pathToDataHandlerConfigDoc - absolute path to the DataHandler configuration document.

Throws:

ServiceReportException - thrown when the configuration document cannot be retrieved.

Method Detail

getData

public void getData(java.lang.String frameworkDomain,
                    java.lang.String frameworkName,
                    java.lang.String frameworkVersion,
                    java.lang.String datasetDomain,
                    java.lang.String datasetName,
                    java.lang.String attributes,
                    java.lang.String geoLinkIds,
                    java.lang.String xsltUrl,
                    java.io.OutputStream fileOut)
             throws ServiceReportException

Handle the GDAS GetData request. More information about the GDAS GetData request and its parameters can be found in the OGC GDAS 0.9.1 Specification section 7.2 . All the calling parameter values are found in the Framework elements of the GDAS GetCapabilities document. All numerical references below are to sections in the GDAS 0.9.1 specification.

Parameters:

frameworkDomain - defined in section 7.2.3.4

frameworkName - defined in section 7.2.3.5

frameworkVersion - defined in section 7.2.3.6

datasetName - defined in section 7.2.3.8

attributes - defined in section 7.2.3.9

geoLinkIds - (optional) defined in section 7.2.3.10

Throws:

ServiceReportException