weblogic.wsee.jaxrpc
Class SoapDispatch

java.lang.Object
  weblogic.wsee.jaxrpc.SoapDispatch

public final class SoapDispatch
extends Object

This class represents

Created: Dec 15, 2004 -- 8:20:13 AM

SOAP_DISPATCH_INITIATED_OPERATION_PROPERTY

public static final String SOAP_DISPATCH_INITIATED_OPERATION_PROPERTY

Deprecated. 

See Also:

Constant Field Values

create

public static SoapDispatch create(String wsdlUrl)
                           throws ServiceException

Deprecated. 

Throws:

ServiceException

create

public static SoapDispatch create(weblogic.wsee.wsdl.WsdlDefinitions defs)

Deprecated. 

getWsdlTargetNamespace

public String getWsdlTargetNamespace()

Deprecated. 

setServiceName

public void setServiceName(QName serviceName)

Deprecated. 

setPortName

public void setPortName(QName portName)

Deprecated. 

createSoapElement

public SOAPElement createSoapElement(String localName,
                                     String prefix,
                                     String namespaceURI)
                              throws ServiceException

Deprecated. 

Throws:

ServiceException

setProperty

public void setProperty(String name,
                        Object value)

Deprecated. 

getProperty

public Object getProperty(String name)

Deprecated. 

getUpdateablePropertyMap

public Map getUpdateablePropertyMap()

Deprecated. 

Gets a live/updateable Map of properties for this SoapDispatch instance. This method is primarily intended for use with WsrmProtocolUtils when interacting with WS-RM protocol in conjunction with invoking operations via SoapDispatch. Note that getUpdateablePropertyMap is used for any parameter called ‘properties’ on a method within WsrmProtocolUtils.

getUpdateableInvokePropertyMap

public Map getUpdateableInvokePropertyMap()

Deprecated. 

Gets a live/updateable Map of 'invoke' properties for this SoapDispatch instance. Invoke properties are properties that are intended to propagate information between calls to the invoke methods. This method is primarily intended for use with WsrmProtocolUtils when interacting with WS-RM protocol in conjunction with invoking operations via SoapDispatch. Note that getUpdateableInvokePropertyMap is used for any parameter called ‘invokeProperties’ on a method within WsrmProtocolUtils.

getEndpointAddressFromInvokeProperties

public String getEndpointAddressFromInvokeProperties()

Deprecated. 

Gets the value of the endpoint address property stored within the 'invoke properties' for this SoapDispatch instance. This method is primarily intended for use with WsrmProtocolUtils when interacting with WS-RM protocol in conjunction with invoking operations via SoapDispatch.

See Also:

SoapDispatch.getUpdateableInvokePropertyMap()

invoke

public SOAPElement invoke(QName method,
                          SOAPElement request)
                   throws ServiceException,
                          RemoteException

Deprecated. 

Throws:

ServiceException

RemoteException

getRequestingServiceURI

public static String getRequestingServiceURI(JwsContext context)

Deprecated. 

getRequestingServiceURI

public static String getRequestingServiceURI(MessageContext context)

Deprecated. 

invokeAsync

public String invokeAsync(String requestingServiceUri,
                          QName method,
                          SOAPElement request,
                          weblogic.wsee.addressing.EndpointReference epr)
                   throws ServiceException,
                          RemoteException

Deprecated. 

Similar to invokeAsync(String, QName, SOAPMessage, EndpointReference) but taking a SOAPElement instead.

Throws:

ServiceException

RemoteException

See Also:

SoapDispatch.invokeAsync(String, QName, SOAPMessage, EndpointReference)

invokeAsync

public String invokeAsync(String requestingServiceUri,
                          QName method,
                          SOAPMessage request,
                          weblogic.wsee.addressing.EndpointReference epr)
                   throws RemoteException,
                          ServiceException

Deprecated. 

Invoke a service operation asynchronously, and receive the response from that service (if any) at a later time. Note, any WsrmConfig settings that are made prior to this invocation will be used in this call.

Parameters:

requestingServiceUri - The URI of the currently executing service that is making this request. This is optional if you specify a non-null epr parameter, but required otherwise. This information is used to properly reestablish the execution environment (e.g. class loader) of the requesting service during async response processing (done via the client handler chain in their processResponse methods). This URI can be obtained by calling SoapDispatch.getRequestingServiceURI(MessageContext context).

If the caller of this method is not executing in a web service context, then they can simply pass null for this parameter. In this case, when the async response is processed within the async response service (via a client handler chain and calling processResponse on that chain), the class loader for the async response service’s application will be used as the context classloader.

method - The QName of the operation to invoke (defined within the WSDL used when constructing this SoapDispatch instance).

request - The SOAPMessage representing the request to send to the service operation.

epr - The EndpointReference for the async response service that should receive the response (asynchronously) from the service when it is available. Note the async response service must be deployed/active to receive the response, and must meet one of the following requirements.

• Be JWS-based where the JWS bean class extends AbstractAsyncResponseBean. The JWS must specify a SOAP 1.1 binding if used to service SOAP 1.1 responses, and must specify a SOAP 1.2 binding if used to service SOAP 1.2 responses
• Be JWS-based and implement an operation with a QName
  new QName("http://www.bea.com/async/AsyncResponseServiceSoap", "onAsyncDelivery") for SOAP 1.1 responses.

new QName("http://www.bea.com/async/AsyncResponseServiceSoap12", "onAsyncDelivery") for SOAP 1.2 responses.
• Specify a WsDeploymentListener that replaces the BEA AsyncResponseHandler, and takes responsibility for processing the async response message and dispatching it to the end consumer.

If null is passed, the async response will be delivered to the default WLS async response service (and thus the caller will be assumed to be JWS-based and have appropriate async response/fault callback methods defined on it). If this is the case, the requestingServiceUri parameter is required, as it will be used to locate the service to which the response will be dispatched.

Returns:

The ID of the request message created from this call.

Throws:

ServiceException

RemoteException

invoke

public SOAPMessage invoke(QName method,
                          SOAPMessage request)
                   throws RemoteException,
                          ServiceException

Deprecated. 

Throws:

RemoteException

ServiceException

getWsrmConfig

public SoapDispatch.WsrmConfig getWsrmConfig()

Deprecated. 

Get an interface that allows you to set WS-RM specific configuration on this SoapDispatch instance. Any configuration set prior to calling any of the invokeAsync methods will be used in that invoke method. This configuration can be changed between successive invocations of the invokeAsync methods. Note, this configuration has no effect when using the normal (sync) invoke methods.

getWsrmUtils

public SoapDispatch.WsrmUtils getWsrmUtils()

Deprecated. 

Get an interface that allows you to perform WS-RM specific operations on this SoapDispatch instance. This interface is generally used after the first invocation of an invokeAsync() method, and before allowing a SoapDispatch instance to be garbage collected. In the case when you will only send a single message via invokeAsync, you may call getWsrmUtils().setLastMessage() prior to the first call to invokeAsync.