com.sun.xml.ws.client.dispatch
Class DispatchImpl<T>

java.lang.Object
  extended by com.sun.xml.ws.client.Stub
      extended by com.sun.xml.ws.client.dispatch.DispatchImpl<T>
All Implemented Interfaces:
Component, ComponentRegistry, ResponseContextReceiver, WSBindingProvider, Closeable, BindingProvider, Dispatch<T>
Direct Known Subclasses:
DataSourceDispatch, JAXBDispatch, MessageDispatch, PacketDispatch, SOAPMessageDispatch

public abstract class DispatchImpl<T>
extends Stub
implements Dispatch<T>

The DispatchImpl abstract class provides support for the dynamic invocation of a service endpoint operation using XML constructs, JAXB objects or SOAPMessage. The javax.xml.ws.Service interface acts as a factory for the creation of DispatchImpl instances.

Version:
1.0
Author:
WS Development Team

Field Summary
 
Fields inherited from class com.sun.xml.ws.client.Stub
addrVersion, binding, endpointReference, operationDispatcher, owner, portInfo, portname, PREVENT_SYNC_START_FOR_ASYNC_INVOKE, requestContext, wsdlPort
 
Fields inherited from interface javax.xml.ws.BindingProvider
ENDPOINT_ADDRESS_PROPERTY, PASSWORD_PROPERTY, SESSION_MAINTAIN_PROPERTY, SOAPACTION_URI_PROPERTY, SOAPACTION_USE_PROPERTY, USERNAME_PROPERTY
 
Constructor Summary
protected DispatchImpl(QName port, Service.Mode mode, WSServiceDelegate owner, Tube pipe, BindingImpl binding, WSEndpointReference epr)
          Deprecated. 
protected DispatchImpl(WSPortInfo portInfo, Service.Mode mode, BindingImpl binding, Tube pipe, WSEndpointReference epr, boolean allowFaultResponseMsg)
           
protected DispatchImpl(WSPortInfo portInfo, Service.Mode mode, BindingImpl binding, WSEndpointReference epr)
           
protected DispatchImpl(WSPortInfo portInfo, Service.Mode mode, BindingImpl binding, WSEndpointReference epr, boolean allowFaultResponseMsg)
           
protected DispatchImpl(WSPortInfo portInfo, Service.Mode mode, Tube pipe, BindingImpl binding, WSEndpointReference epr, boolean allowFaultResponseMsg)
           
 
Method Summary
static void checkValidDataSourceDispatch(WSBinding binding, Service.Mode mode)
           
static void checkValidSOAPMessageDispatch(WSBinding binding, Service.Mode mode)
           
static Dispatch<Source> createSourceDispatch(QName port, Service.Mode mode, WSServiceDelegate owner, Tube pipe, BindingImpl binding, WSEndpointReference epr)
          Deprecated. 
static Dispatch<Source> createSourceDispatch(WSPortInfo portInfo, Service.Mode mode, BindingImpl binding, WSEndpointReference epr)
           
 T doInvoke(T in, RequestContext rc, ResponseContextReceiver receiver)
          Synchronously invokes a service.
 QName getPortName()
          Gets the port name that this stub is configured to talk to.
 T invoke(T in)
           
 Response<T> invokeAsync(T param)
           
 Future<?> invokeAsync(T param, AsyncHandler<T> asyncHandler)
           
 void invokeOneWay(T in)
           
protected  String resolveURI(URI endpointURI, String pathInfo, String queryString)
           
protected  AttachmentSet setOutboundAttachments()
           
 void setOutboundHeaders(Object... headers)
          Sets the out-bound headers to be added to messages sent from this BindingProvider.
 
Methods inherited from class com.sun.xml.ws.client.Stub
close, configureFiber, getBinding, getComponents, getEndpointReference, getEndpointReference, getExecutor, getInboundHeaders, getManagedObjectManager, getOperationDispatcher, getPortInfo, getRequestContext, getResponseContext, getService, getServiceName, getSPI, getTubes, getWSDLPort, getWSEndpointReference, process, processAsync, resetRequestContext, setAddress, setOutboundHeaders, setOutboundHeaders, setResponseContext, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface javax.xml.ws.BindingProvider
getBinding, getEndpointReference, getEndpointReference, getRequestContext, getResponseContext
 

Constructor Detail

DispatchImpl

@Deprecated
protected DispatchImpl(QName port,
                                  Service.Mode mode,
                                  WSServiceDelegate owner,
                                  Tube pipe,
                                  BindingImpl binding,
                                  @Nullable
                                  WSEndpointReference epr)
Deprecated. 

Parameters:
port - dispatch instance is associated with this wsdl port qName
mode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOAD
owner - Service that created the Dispatch
pipe - Master pipe for the pipeline
binding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTP

DispatchImpl

protected DispatchImpl(WSPortInfo portInfo,
                       Service.Mode mode,
                       BindingImpl binding,
                       @Nullable
                       WSEndpointReference epr)
Parameters:
portInfo - dispatch instance is associated with this portInfo
mode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOAD
binding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTP

DispatchImpl

protected DispatchImpl(WSPortInfo portInfo,
                       Service.Mode mode,
                       BindingImpl binding,
                       @Nullable
                       WSEndpointReference epr,
                       boolean allowFaultResponseMsg)
Parameters:
portInfo - dispatch instance is associated with this portInfo
mode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOAD
binding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTP
allowFaultResponseMsg - A packet containing a SOAP fault message is allowed as the response to a request on this dispatch instance.

DispatchImpl

protected DispatchImpl(WSPortInfo portInfo,
                       Service.Mode mode,
                       BindingImpl binding,
                       Tube pipe,
                       @Nullable
                       WSEndpointReference epr,
                       boolean allowFaultResponseMsg)
Parameters:
portInfo - dispatch instance is associated with this portInfo
mode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOAD
binding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTP
pipe - Master pipe for the pipeline
allowFaultResponseMsg - A packet containing a SOAP fault message is allowed as the response to a request on this dispatch instance.

DispatchImpl

protected DispatchImpl(WSPortInfo portInfo,
                       Service.Mode mode,
                       Tube pipe,
                       BindingImpl binding,
                       @Nullable
                       WSEndpointReference epr,
                       boolean allowFaultResponseMsg)
Parameters:
portportInfo - dispatch instance is associated with this wsdl port qName
mode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOAD
pipe - Master pipe for the pipeline
binding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTP
allowFaultResponseMsg - A packet containing a SOAP fault message is allowed as the response to a request on this dispatch instance.
Method Detail

invokeAsync

public final Response<T> invokeAsync(T param)
Specified by:
invokeAsync in interface Dispatch<T>

invokeAsync

public final Future<?> invokeAsync(T param,
                                   AsyncHandler<T> asyncHandler)
Specified by:
invokeAsync in interface Dispatch<T>

doInvoke

public final T doInvoke(T in,
                        RequestContext rc,
                        ResponseContextReceiver receiver)
Synchronously invokes a service. See Stub.process(Packet, RequestContext, ResponseContextReceiver) on why it takes a RequestContext and ResponseContextReceiver as a parameter.


invoke

public final T invoke(T in)
Specified by:
invoke in interface Dispatch<T>

invokeOneWay

public final void invokeOneWay(T in)
Specified by:
invokeOneWay in interface Dispatch<T>

checkValidSOAPMessageDispatch

public static void checkValidSOAPMessageDispatch(WSBinding binding,
                                                 Service.Mode mode)

checkValidDataSourceDispatch

public static void checkValidDataSourceDispatch(WSBinding binding,
                                                Service.Mode mode)

getPortName

@NotNull
public final QName getPortName()
Description copied from class: Stub
Gets the port name that this stub is configured to talk to.

When Stub.wsdlPort is non-null, the port name is always the same as WSDLPort.getName(), but this method returns a port name even if no WSDL is available for this stub.

Specified by:
getPortName in class Stub

resolveURI

@NotNull
protected String resolveURI(@NotNull
                                    URI endpointURI,
                                    @Nullable
                                    String pathInfo,
                                    @Nullable
                                    String queryString)

setOutboundAttachments

protected AttachmentSet setOutboundAttachments()

setOutboundHeaders

public void setOutboundHeaders(Object... headers)
Description copied from interface: WSBindingProvider
Sets the out-bound headers to be added to messages sent from this BindingProvider.

Each object must be a JAXB-bound object that is understood by the JAXBContext object known by this WSBindingProvider (that is, if this is a Dispatch with JAXB, then JAXBContext given to Service.createDispatch(QName,JAXBContext,Mode) and if this is a typed proxy, then JAXBContext implicitly created by the JAX-WS RI.)

Specified by:
setOutboundHeaders in interface WSBindingProvider
Parameters:
headers - Can be null or empty.

createSourceDispatch

@Deprecated
public static Dispatch<Source> createSourceDispatch(QName port,
                                                               Service.Mode mode,
                                                               WSServiceDelegate owner,
                                                               Tube pipe,
                                                               BindingImpl binding,
                                                               WSEndpointReference epr)
Deprecated. 


createSourceDispatch

public static Dispatch<Source> createSourceDispatch(WSPortInfo portInfo,
                                                    Service.Mode mode,
                                                    BindingImpl binding,
                                                    WSEndpointReference epr)


Copyright © 2005-2015 Oracle Corporation. All Rights Reserved.