org.deegree.protocol.wps.client.process
Class Process

java.lang.Object
  org.deegree.protocol.wps.client.process.Process

public class Process
extends java.lang.Object

Encapsulates the properties of a process offered by a WPS instance (id, title, abstract, input parameter types, output parameter types, etc.) and provides access to a ProcessExecution context for executing it.

Version:

$Revision: 26137 $, $Date: 2010-08-25 18:05:25 +0200 (Mi, 25. Aug 2010) $

Author:

Christian Kiehle, Georg Walenciak, Andrei Ionita, Markus Schneider, last edited by: $Author: aionita $

See Also:

WPSClient, ProcessExecution

Constructor Summary

Process(WPSClient client, ProcessInfo processInfo)
Creates a new Process instance.

Method Summary

LanguageString	getAbstract() Returns the abstract of the process.
CodeType	getId() Returns the identifier of the process.
InputType[]	getInputTypes() Returns the descriptions for all input parameters of the process.
OutputType[]	getOutputTypes() Returns the descriptions for all output parameters of the process.
boolean	getStatusSupported() Returns whether the process supports polling of status information during asynchronous execution.
boolean	getStoreSupported() Returns whether the process supports storing of the response document (=asynchronous execution).
LanguageString	getTitle() Returns the title of the process.
java.lang.String	getVersion() Returns the version of the process.
ProcessExecution	prepareExecution() Prepares a new ProcessExecution context that allows to execute the process.
RawProcessExecution	prepareRawExecution() Prepares a new RawProcessExecution context that allows to execute the process using the WPS RawOutput mode.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Process

public Process(WPSClient client,
               ProcessInfo processInfo)

Creates a new Process instance.

Parameters:

client - associated client instance, must not be null

processInfo - brief process info, must not be null

Method Detail

getId

public CodeType getId()

Returns the identifier of the process.

Returns:

the identifier, never null

getVersion

public java.lang.String getVersion()

Returns the version of the process.

Returns:

the version, never null

getTitle

public LanguageString getTitle()

Returns the title of the process.

Returns:

the title, never null

getAbstract

public LanguageString getAbstract()

Returns the abstract of the process.

Returns:

the abstract, can be null (if the process description does not define an abstract)

getInputTypes

public InputType[] getInputTypes()
                          throws java.io.IOException,
                                 OWSException

Returns the descriptions for all input parameters of the process.

Returns:

the descriptions for all input parameters, can be empty, but never null

Throws:

java.io.IOException - if a communication/network problem occured

OWSException - if the server replied with an exception

getOutputTypes

public OutputType[] getOutputTypes()
                            throws java.io.IOException,
                                   OWSException

Returns the descriptions for all output parameters of the process.

Returns:

the descriptions for all output parameters, can be empty, but never null

Throws:

java.io.IOException - if a communication/network problem occured

OWSException - if the server replied with an exception

getStoreSupported

public boolean getStoreSupported()
                          throws OWSException,
                                 java.io.IOException

Returns whether the process supports storing of the response document (=asynchronous execution).

Returns:

true, if the process supports storing the response document, false otherwise

Throws:

java.io.IOException - if a communication/network problem occured

OWSException - if the server replied with an exception

getStatusSupported

public boolean getStatusSupported()
                           throws OWSException,
                                  java.io.IOException

Returns whether the process supports polling of status information during asynchronous execution.

Returns:

true, if the process supports polling status information, false otherwise

Throws:

java.io.IOException - if a communication/network problem occured

OWSException - if the server replied with an exception

prepareExecution

public ProcessExecution prepareExecution()

Prepares a new ProcessExecution context that allows to execute the process.

This method will request the response using the WPS ResponseDocument mode. If you're unsure, this is most probably what you want, as it is the most flexible way of executing WPS processes.

Returns:

new process execution context, never null

prepareRawExecution

public RawProcessExecution prepareRawExecution()

Prepares a new RawProcessExecution context that allows to execute the process using the WPS RawOutput mode.

If you're unsure, then you most probably want to use prepareExecution(), as the RawOutput mode is rather restricted: just a single (complex) output, no asynchronous execution, no storing of output.

Returns:

new process execution context, never null

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object