Package net.webpdf.wsclient.webservice.soap

Class ToolboxWebService<T_SOAP_DOCUMENT extends SoapDocument>

java.lang.Object

net.webpdf.wsclient.webservice.AbstractWebService<SoapSession<T_SOAP_DOCUMENT>,OperationData,T_OPERATION_PARAMETER,T_SOAP_DOCUMENT,BillingType,PdfPasswordType,SettingsType>

net.webpdf.wsclient.webservice.soap.SoapWebService<Toolbox,List<BaseToolboxType>,T_SOAP_DOCUMENT>

net.webpdf.wsclient.webservice.soap.ToolboxWebService<T_SOAP_DOCUMENT>

Type Parameters:

T_SOAP_DOCUMENT - The expected SoapDocument type for the documents used by the webPDF server.

All Implemented Interfaces:

WebService<SoapSession<T_SOAP_DOCUMENT>,List<BaseToolboxType>,T_SOAP_DOCUMENT,BillingType,PdfPasswordType,SettingsType>

public class ToolboxWebService<T_SOAP_DOCUMENT extends SoapDocument>
extends SoapWebService<Toolbox,List<BaseToolboxType>,T_SOAP_DOCUMENT>

An instance of ToolboxWebService wraps a wsclient connection to the webPDF webservice endpoint WebServiceType.TOOLBOX, using WebServiceProtocol.SOAP and expecting a SoapDocument as the result.

Constructor Summary

Constructors

Constructor	Description
ToolboxWebService(@NotNull SoapSession<T_SOAP_DOCUMENT> session)	Creates a ToolboxWebService for the given SoapSession.

Method Summary

Modifier and Type	Method	Description
@NotNull List<BaseToolboxType>	getOperationParameters()	Returns the ToolboxWebService specific BaseToolboxType, which allows setting parameters for the webservice execution.
protected @NotNull OperationData	initOperation()	Initializes and prepares the execution of this ToolboxWebService.
protected @Nullable jakarta.activation.DataHandler	processService(T_SOAP_DOCUMENT sourceDocument)	Executes the ToolboxWebService operation and returns the DataHandler of the result document.
protected @NotNull Toolbox	provideWebServicePort()	Create a matching Toolbox webservice port for future executions of this SoapWebService.
void	setOperationParameters(@Nullable List<BaseToolboxType> operationData)	Sets the ToolboxWebService specific BaseToolboxType element, which allows setting parameters for the webservice execution.

Methods inherited from class net.webpdf.wsclient.webservice.soap.SoapWebService

getBilling, getMTOMFeature, getPassword, getPort, getQName, getSettings, getWsdlDocumentLocation, process, process, setBilling, setPassword, setSettings

Methods inherited from class net.webpdf.wsclient.webservice.AbstractWebService

getAdditionalParameter, getHeaders, getOperationData, getSession, getWebServiceType

Methods inherited from class java.lang.Object

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

Constructor Detail

ToolboxWebService

public ToolboxWebService(@NotNull
                         @NotNull SoapSession<T_SOAP_DOCUMENT> session)
                  throws ResultException

Creates a ToolboxWebService for the given SoapSession.

Parameters:

session - The SoapSession a ToolboxWebService shall be created for.

Throws:

ResultException - Shall be thrown, upon an execution failure.

Method Detail

processService

@Nullable
protected @Nullable jakarta.activation.DataHandler processService(@NotNull
                                                                  T_SOAP_DOCUMENT sourceDocument)
                                                           throws WebServiceException

Executes the ToolboxWebService operation and returns the DataHandler of the result document.

Be aware: SOAP webservices may not be executed without a sourceDocument. It is required, that you at least create a dummy document, such as: new SoapWebServiceDocument() for webservices not requiring a source document. (Such as the URL-converter.)

Specified by:

processService in class SoapWebService<Toolbox,List<BaseToolboxType>,T_SOAP_DOCUMENT extends SoapDocument>

Parameters:

sourceDocument - The source ToolboxWebService, that shall be processed.

Returns:

The DataHandler of the result document.

Throws:

WebServiceException - Shall be thrown, upon an execution failure.

getOperationParameters

@NotNull
public @NotNull List<BaseToolboxType> getOperationParameters()

Returns the ToolboxWebService specific BaseToolboxType, which allows setting parameters for the webservice execution.

Returns:

The BaseToolboxType operation parameters.

setOperationParameters

public void setOperationParameters(@Nullable
                                   @Nullable List<BaseToolboxType> operationData)

Sets the ToolboxWebService specific BaseToolboxType element, which allows setting parameters for the webservice execution.

Parameters:

operationData - Sets the BaseToolboxType operation parameters.

provideWebServicePort

@NotNull
protected @NotNull Toolbox provideWebServicePort()
                                          throws ResultException

Create a matching Toolbox webservice port for future executions of this SoapWebService.

Specified by:

provideWebServicePort in class SoapWebService<Toolbox,List<BaseToolboxType>,T_SOAP_DOCUMENT extends SoapDocument>

Returns:

The Toolbox webservice port, that shall be used for executions.

Throws:

ResultException - Shall be thrown, upon an execution failure.

initOperation

@NotNull
protected @NotNull OperationData initOperation()

Initializes and prepares the execution of this ToolboxWebService.

Specified by:

initOperation in class AbstractWebService<SoapSession<T_SOAP_DOCUMENT extends SoapDocument>,OperationData,List<BaseToolboxType>,T_SOAP_DOCUMENT extends SoapDocument,BillingType,PdfPasswordType,SettingsType>

Returns:

The prepared OperationData.