org.deegree.services.controller.wps
Class WPSController

java.lang.Object
  org.deegree.services.controller.AbstractOGCServiceController
      org.deegree.services.controller.wps.WPSController

public class WPSController
extends AbstractOGCServiceController

Handles WPS (WebProcessingService) protocol requests and acts as the link between the OGCFrontController and the WPService.

Supported WPS protocol versions:

• 1.0.0

Version:

$Revision: 22859 $, $Date: 2010-03-04 11:24:36 +0100 (Do, 04 Mrz 2010) $

Author:

Alexander Padberg, Rutger Bezema, Markus Schneider , last edited by: $Author: aionita $

See Also:

WPService, AbstractOGCServiceController, OGCFrontController

Field Summary

Fields inherited from class org.deegree.services.controller.AbstractOGCServiceController

JAXB_CONFIG_CLASSPATH, mainControllerConf, offeredVersions

Constructor Summary

WPSController()

Method Summary

void	destroy() Called by the OGCFrontController to indicate to a subcontroller that the subcontroller is being taken out of service.
void	doKVP(Map<String,String> kvpParamsUC, javax.servlet.http.HttpServletRequest request, HttpResponseBuffer response, List<org.apache.commons.fileupload.FileItem> multiParts) Called by the OGCFrontController to allow this AbstractOGCServiceController to handle a KVP request.
void	doSOAP(org.apache.axiom.soap.SOAPEnvelope soapDoc, javax.servlet.http.HttpServletRequest request, HttpResponseBuffer response, List<org.apache.commons.fileupload.FileItem> multiParts, org.apache.axiom.soap.SOAPFactory factory) Called by the OGCFrontController to allow this AbstractOGCServiceController to handle a SOAP 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 AbstractOGCServiceController to handle an XML request.
org.deegree.commons.utils.Pair<XMLExceptionSerializer<OWSException>,String>	getExceptionSerializer(org.deegree.commons.types.ows.Version requestVersion) Returns the ExceptionSerializer and mime-type suitable for the given request version.
ExecutionManager	getExecutionManager() Returns the associated ExecutionManager instance.
WPService	getService() Returns the underlying WPService instance.
void	init(org.deegree.commons.xml.XMLAdapter controllerConf, DeegreeServicesMetadata serviceMetadata) Called by the OGCFrontController to indicate to a subcontroller that it is being taken into service.
(package private) void	sendServiceException(OWSException ex, HttpResponseBuffer response)

Methods inherited from class org.deegree.services.controller.AbstractOGCServiceController

beginSOAPResponse, checkConfigVersion, checkOrCreateDCPGetURL, checkOrCreateDCPPostURL, checkVersion, endSOAPResponse, getHandledNamespaces, getHandledRequests, getOfferedVersionsString, getSchemaForUrl, getUnmarshaller, init, negotiateVersion, sendException, sendSOAPException, synchronizeServiceIdentificationWithMainController, synchronizeServiceProviderWithMainControllerConf, validateAndSetOfferedVersions

Methods inherited from class java.lang.Object

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

Constructor Detail

WPSController

public WPSController()

Method Detail

init

public void init(org.deegree.commons.xml.XMLAdapter controllerConf,
                 DeegreeServicesMetadata serviceMetadata)
          throws ControllerInitException

Description copied from class: AbstractOGCServiceController

Called by the OGCFrontController to indicate to a subcontroller that it is being taken into service.

Specified by:

init in class AbstractOGCServiceController

Parameters:

controllerConf - provides access to the (always xml-based) configuration of the controller

serviceMetadata - services metadata from the main service configuration for all services

Throws:

ControllerInitException - indicates that the initialization failed

destroy

public void destroy()

Description copied from class: AbstractOGCServiceController

Called by the OGCFrontController to indicate to a subcontroller that the subcontroller is being taken out of service.

Specified by:

destroy in class AbstractOGCServiceController

doKVP

public void doKVP(Map<String,String> kvpParamsUC,
                  javax.servlet.http.HttpServletRequest request,
                  HttpResponseBuffer response,
                  List<org.apache.commons.fileupload.FileItem> multiParts)
           throws javax.servlet.ServletException,
                  IOException

Description copied from class: AbstractOGCServiceController

Called by the OGCFrontController to allow this AbstractOGCServiceController to handle a KVP request.

Specified by:

doKVP in class AbstractOGCServiceController

Parameters:

kvpParamsUC - request parameters (keys are uppercased)

request - provides access to all information of the original HTTP request (NOTE: may be GET or POST)

response - response that is sent to the client

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 class: AbstractOGCServiceController

Called by the OGCFrontController to allow this AbstractOGCServiceController to handle an XML request.

Specified by:

doXML in class AbstractOGCServiceController

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

doSOAP

public void doSOAP(org.apache.axiom.soap.SOAPEnvelope soapDoc,
                   javax.servlet.http.HttpServletRequest request,
                   HttpResponseBuffer response,
                   List<org.apache.commons.fileupload.FileItem> multiParts,
                   org.apache.axiom.soap.SOAPFactory factory)
            throws javax.servlet.ServletException,
                   IOException

Description copied from class: AbstractOGCServiceController

Called by the OGCFrontController to allow this AbstractOGCServiceController to handle a SOAP request.

Overrides:

doSOAP in class AbstractOGCServiceController

Parameters:

soapDoc - XMLAdapter for parsing the SOAP request document

request - provides access to all information of the original HTTP request (NOTE: may be GET or POST)

response - response that is sent to the client

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.

factory - initialized to the soap version of the request.

Throws:

javax.servlet.ServletException

IOException - if an IOException occurred

getService

public WPService getService()

Returns the underlying WPService instance.

Returns:

the underlying WPService

getExecutionManager

public ExecutionManager getExecutionManager()

Returns the associated ExecutionManager instance.

Returns:

the associated ExecutionManager

sendServiceException

void sendServiceException(OWSException ex,
                          HttpResponseBuffer response)
                    throws javax.servlet.ServletException

Throws:

javax.servlet.ServletException

getExceptionSerializer

public org.deegree.commons.utils.Pair<XMLExceptionSerializer<OWSException>,String> getExceptionSerializer(org.deegree.commons.types.ows.Version requestVersion)

Description copied from class: AbstractOGCServiceController

Returns the ExceptionSerializer and mime-type suitable for the given request version.

Overrides:

getExceptionSerializer in class AbstractOGCServiceController

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