org.deegree.services.sos
Class SOSController

java.lang.Object
  extended by org.deegree.services.controller.AbstractOWS
      extended by org.deegree.services.sos.SOSController
All Implemented Interfaces:
Resource, OWS

public class SOSController
extends AbstractOWS

Implementation of the OpenGIS Sensor Observation Service server protocol.

 Note: The SOS 1.0.0 specification doesn't define KVP requests. It is an acknowledged flaw in the spec. Regardless of
 that, some other SOS implemented KVP requests. The deegree SOS follows the KVP requests format of the following implementations.
  - http://www.oostethys.org/best-practices/best-practices-get    
  - http://mapserver.gis.umn.edu/docs/howto/sos_server/#getcapabilities-request
 

Version:
$Revision: 31896 $, $Date: 2011-09-15 15:12:23 +0200 (Thu, 15 Sep 2011) $
Author:
Oliver Tonnhofer, last edited by: $Author: mschneider $

Field Summary
 
Fields inherited from class org.deegree.services.controller.AbstractOWS
mainControllerConf, mainMetadataConf, offeredVersions, serviceInfo, workspace
 
Constructor Summary
SOSController(URL configURL, ImplementationMetadata serviceInfo)
           
 
Method Summary
 void destroy()
          Usually called by the ResourceManager upon workspace shutdown.
 void doKVP(Map<String,String> param, javax.servlet.http.HttpServletRequest request, HttpResponseBuffer response, List<org.apache.commons.fileupload.FileItem> multiParts)
          Called by the OGCFrontController to allow this OWS to handle an OGC-KVP request.
 void doXML(XMLStreamReader xmlStream, javax.servlet.http.HttpServletRequest request, HttpResponseBuffer response, List<org.apache.commons.fileupload.FileItem> multiParts)
          Called by the OGCFrontController to allow this OWS to handle an OGC-XML request.
 Pair<XMLExceptionSerializer<OWSException>,String> getExceptionSerializer(Version requestVersion)
          Returns the ExceptionSerializer and mime-type suitable for the given request version.
 void init(DeegreeServicesMetadataType serviceMetadata, DeegreeServiceControllerType mainConf, ImplementationMetadata<?> md, XMLAdapter controllerConf)
          Initializes the AbstractOWS instance.
 
Methods inherited from class org.deegree.services.controller.AbstractOWS
beginSOAPResponse, checkConfigVersion, checkVersion, doSOAP, endSOAPResponse, getHandledNamespaces, getHandledRequests, getImplementationMetadata, getOfferedVersions, getOfferedVersionsString, init, negotiateVersion, sendException, sendException, sendSOAPException, synchronizeServiceIdentificationWithMainController, synchronizeServiceProviderWithMainControllerConf, unmarshallConfig, unmarshallConfig, validateAndSetOfferedVersions
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SOSController

public SOSController(URL configURL,
                     ImplementationMetadata serviceInfo)
Method Detail

init

public void init(DeegreeServicesMetadataType serviceMetadata,
                 DeegreeServiceControllerType mainConf,
                 ImplementationMetadata<?> md,
                 XMLAdapter controllerConf)
          throws ResourceInitException
Description copied from class: AbstractOWS
Initializes the AbstractOWS instance.

Overrides:
init in class AbstractOWS
controllerConf - controller configuration, must not be null
Throws:
ResourceInitException

destroy

public void destroy()
Description copied from interface: Resource
Usually called by the ResourceManager upon workspace shutdown.


doKVP

public void doKVP(Map<String,String> param,
                  javax.servlet.http.HttpServletRequest request,
                  HttpResponseBuffer response,
                  List<org.apache.commons.fileupload.FileItem> multiParts)
           throws javax.servlet.ServletException,
                  IOException
Description copied from interface: OWS
Called by the OGCFrontController to allow this OWS to handle an OGC-KVP request.

Parameters:
param - request parameters (keys are uppercased), never null
request - provides access to all information of the original HTTP request (NOTE: may be GET or POST), never null
response - response that is sent to the client, never null
multiParts - A list of multiparts contained in the request. If the request was not a multipart request the list will be null. If multiparts were found, the requestDoc will be the first (xml-lized) FileItem in the list.
Throws:
javax.servlet.ServletException
IOException

doXML

public void doXML(XMLStreamReader xmlStream,
                  javax.servlet.http.HttpServletRequest request,
                  HttpResponseBuffer response,
                  List<org.apache.commons.fileupload.FileItem> multiParts)
           throws javax.servlet.ServletException,
                  IOException
Description copied from interface: OWS
Called by the OGCFrontController to allow this OWS to handle an OGC-XML request.

Parameters:
xmlStream - provides access to the XML request, cursor points to the START_ELEMENT event of the root element, never null
request - provides access to all information of the original HTTP request (NOTE: may be GET or POST), never null
response - response that is sent to the client, never null
multiParts - A list of multiparts contained in the request. If the request was not a multipart request the list will be null. If multiparts were found, the xmlStream will provide access to the first (xml-lized) FileItem in the list of multi parts
Throws:
javax.servlet.ServletException
IOException

getExceptionSerializer

public Pair<XMLExceptionSerializer<OWSException>,String> getExceptionSerializer(Version requestVersion)
Description copied from class: AbstractOWS
Returns the ExceptionSerializer and mime-type suitable for the given request version.

Specified by:
getExceptionSerializer in interface OWS
Overrides:
getExceptionSerializer in class AbstractOWS
Parameters:
requestVersion - version of the request for which the exception has to be produced, may be null (implies that the serializer and mime type for the highest supported version shall be returned)
Returns:
an OWSCommon 1.1.0 XML adapter by default, never null


Copyright © 2011. All Rights Reserved.