org.ws4d.java.service

Class OperationStub

java.lang.Object

org.ws4d.java.types.AttributableSupport

org.ws4d.java.service.OperationCommons

org.ws4d.java.service.Operation

org.ws4d.java.service.OperationStub

All Implemented Interfaces:

OperationDescription, Attributable

public class OperationStub
extends Operation

Instances of this class are used during dynamic creation of a service via the method DefaultService.define(org.ws4d.java.types.URI, CredentialInfo) . They provide a way to detach the business logic of an operation from its metadata by means of InvokeDelegate instances.

Field Summary

Fields inherited from class org.ws4d.java.service.OperationCommons

inputAttributable, outputAttributable, type

Fields inherited from class org.ws4d.java.types.AttributableSupport

attributes

Constructor Summary

Constructors

Constructor and Description
OperationStub(java.lang.String name, QName portType) Creates a new operation stub with the given name and port type.

Method Summary

Modifier and Type	Method and Description
InvokeDelegate	getDelegate() Returns the current delegate.
ParameterValue	invokeImpl(ParameterValue parameterValue, CredentialInfo credentialInfo) This method must be overwritten from User.
void	setDelegate(InvokeDelegate delegate) Sets the delegate which shall receive invocation requests from this operation.

Methods inherited from class org.ws4d.java.service.Operation

getType, invoke, invoke, isOneWay, isRequestResponse

Methods inherited from class org.ws4d.java.service.OperationCommons

addCustomComplexType, addFault, addInputParameter, addOutputParameter, clearCustomComplexTypes, createFaultValue, createFaultValue, createInputValue, createInputValue, createOutputValue, createOutputValue, equals, getCustomComplexTypes, getFault, getFaultAttribute, getFaultAttributes, getFaultCount, getFaults, getInput, getInputAction, getInputAttribute, getInputAttributes, getInputName, getInputParameter, getName, getNameQuallified, getOutput, getOutputAction, getOutputAttribute, getOutputAttributes, getOutputName, getOutputParameter, getPortType, getService, hasFaultAttributes, hashCode, hasInputAttributes, hasOutputAttributes, isInputActionSet, isInputNameSet, isOutputActionSet, isOutputNameSet, removeCustomComplexType, removeFault, setFaultAttribute, setFaultAttributes, setInput, setInputAction, setInputAttribute, setInputAttributes, setInputName, setInputNameInternal, setOutput, setOutputAction, setOutputAttribute, setOutputAttributes, setOutputName, setOutputNameInternal, setService, toString

Methods inherited from class org.ws4d.java.types.AttributableSupport

getAttribute, getAttributes, hasAttributes, serializeAttributes, setAttribute, setAttribute, setAttributes

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

OperationStub

public OperationStub(java.lang.String name,
                     QName portType)

Creates a new operation stub with the given name and port type.

Parameters:

name - the name of the operation

portType - the name of the port type to which this operation belongs

Method Detail

invokeImpl

public ParameterValue invokeImpl(ParameterValue parameterValue,
                                 CredentialInfo credentialInfo)
                          throws InvocationException,
                                 CommunicationException

Description copied from class: Operation

This method must be overwritten from User. This method will inherit the relevant code for invoking the operation.

Specified by:

invokeImpl in class Operation

Returns:

ParameterValue

Throws:

InvocationException

CommunicationException

getDelegate

public InvokeDelegate getDelegate()

Returns the current delegate. Returns null if either none set or explicitly set to null.

Returns:

the delegate the current delegate instance or null

setDelegate

public void setDelegate(InvokeDelegate delegate)

Sets the delegate which shall receive invocation requests from this operation. If delegate is null, a default one will be installed, which throws an InvocationException with a code of {SOAPConstants#SOAP_FAULT_SENDER} and a subcode of WS4DConstants.WS4D_FAULT_NOT_IMPLEMENTED. However, calling the method getDelegate() afterwards will return null instead of this default InvokeDelegate.

Parameters:

delegate - the delegate to set or null to fall back to a default implementation throwing an InvocationException with a code of {SOAPConstants#SOAP_FAULT_SENDER} and a subcode of WS4DConstants.WS4D_FAULT_NOT_IMPLEMENTED on each call to Operation.invoke(ParameterValue)