|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.sun.xml.ws.client.Stub
com.sun.xml.ws.client.dispatch.DispatchImpl<T>
public abstract class DispatchImpl<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.
| Field Summary | |
|---|---|
(package private) boolean |
allowFaultResponseMsg
|
(package private) static long |
AWAIT_TERMINATION_TIME
|
(package private) static String |
HTTP_REQUEST_METHOD_GET
|
(package private) static String |
HTTP_REQUEST_METHOD_POST
|
(package private) static String |
HTTP_REQUEST_METHOD_PUT
|
(package private) Service.Mode |
mode
|
(package private) SOAPVersion |
soapVersion
|
| 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 | |
|---|---|
(package private) static void |
checkNullAllowed(Object in,
RequestContext rc,
WSBinding binding,
Service.Mode mode)
|
static void |
checkValidDataSourceDispatch(WSBinding binding,
Service.Mode mode)
|
static void |
checkValidSOAPMessageDispatch(WSBinding binding,
Service.Mode mode)
|
(package private) abstract Packet |
createPacket(T msg)
Abstract method that is implemented by each concrete Dispatch class |
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)
|
(package private) static boolean |
isPAYLOADMode(Service.Mode mode)
|
(package private) static boolean |
isXMLHttp(WSBinding binding)
|
(package private) static boolean |
methodNotOk(RequestContext rc)
|
(package private) void |
resolveEndpointAddress(Packet message,
RequestContext requestContext)
|
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. |
(package private) void |
setProperties(Packet packet,
boolean expectReply)
|
(package private) abstract T |
toReturnValue(Packet response)
Obtains the value to return from the response message. |
| Methods inherited from class com.sun.xml.ws.client.Stub |
|---|
close, 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 |
| Field Detail |
|---|
final Service.Mode mode
final SOAPVersion soapVersion
final boolean allowFaultResponseMsg
static final long AWAIT_TERMINATION_TIME
static final String HTTP_REQUEST_METHOD_GET
static final String HTTP_REQUEST_METHOD_POST
static final String HTTP_REQUEST_METHOD_PUT
| Constructor Detail |
|---|
@Deprecated
protected DispatchImpl(QName port,
Service.Mode mode,
WSServiceDelegate owner,
Tube pipe,
BindingImpl binding,
@Nullable
WSEndpointReference epr)
port - dispatch instance is associated with this wsdl port qNamemode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOADowner - Service that created the Dispatchpipe - Master pipe for the pipelinebinding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTP
protected DispatchImpl(WSPortInfo portInfo,
Service.Mode mode,
BindingImpl binding,
@Nullable
WSEndpointReference epr)
portInfo - dispatch instance is associated with this portInfomode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOADbinding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTP
protected DispatchImpl(WSPortInfo portInfo,
Service.Mode mode,
BindingImpl binding,
@Nullable
WSEndpointReference epr,
boolean allowFaultResponseMsg)
portInfo - dispatch instance is associated with this portInfomode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOADbinding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTPallowFaultResponseMsg - A packet containing a SOAP fault message is allowed as the response to a request on this dispatch instance.
protected DispatchImpl(WSPortInfo portInfo,
Service.Mode mode,
BindingImpl binding,
Tube pipe,
@Nullable
WSEndpointReference epr,
boolean allowFaultResponseMsg)
portInfo - dispatch instance is associated with this portInfomode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOADbinding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTPpipe - Master pipe for the pipelineallowFaultResponseMsg - A packet containing a SOAP fault message is allowed as the response to a request on this dispatch instance.
protected DispatchImpl(WSPortInfo portInfo,
Service.Mode mode,
Tube pipe,
BindingImpl binding,
@Nullable
WSEndpointReference epr,
boolean allowFaultResponseMsg)
port - dispatch instance is associated with this wsdl port qNamemode - Service.mode associated with this Dispatch instance - Service.mode.MESSAGE or Service.mode.PAYLOADowner - Service that created the Dispatchpipe - Master pipe for the pipelinebinding - Binding of this Dispatch instance, current one of SOAP/HTTP or XML/HTTPallowFaultResponseMsg - A packet containing a SOAP fault message is allowed as the response to a request on this dispatch instance.| Method Detail |
|---|
abstract Packet createPacket(T msg)
msg - message passed in from the client program on the invocation
abstract T toReturnValue(Packet response)
public final Response<T> invokeAsync(T param)
invokeAsync in interface Dispatch<T>
public final Future<?> invokeAsync(T param,
AsyncHandler<T> asyncHandler)
invokeAsync in interface Dispatch<T>
public final T doInvoke(T in,
RequestContext rc,
ResponseContextReceiver receiver)
Stub.process(Packet, RequestContext, ResponseContextReceiver) on
why it takes a RequestContext and ResponseContextReceiver as a parameter.
public final T invoke(T in)
invoke in interface Dispatch<T>public final void invokeOneWay(T in)
invokeOneWay in interface Dispatch<T>
void setProperties(Packet packet,
boolean expectReply)
static boolean isXMLHttp(@NotNull
WSBinding binding)
static boolean isPAYLOADMode(@NotNull
Service.Mode mode)
static void checkNullAllowed(@Nullable
Object in,
RequestContext rc,
WSBinding binding,
Service.Mode mode)
static boolean methodNotOk(@NotNull
RequestContext rc)
public static void checkValidSOAPMessageDispatch(WSBinding binding,
Service.Mode mode)
public static void checkValidDataSourceDispatch(WSBinding binding,
Service.Mode mode)
@NotNull public final QName getPortName()
Stub
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.
getPortName in class Stub
void resolveEndpointAddress(@NotNull
Packet message,
@NotNull
RequestContext requestContext)
@NotNull
protected String resolveURI(@NotNull
URI endpointURI,
@Nullable
String pathInfo,
@Nullable
String queryString)
protected AttachmentSet setOutboundAttachments()
public void setOutboundHeaders(Object... headers)
WSBindingProviderBindingProvider.
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.)
setOutboundHeaders in interface WSBindingProviderheaders - Can be null or empty.
@Deprecated
public static Dispatch<Source> createSourceDispatch(QName port,
Service.Mode mode,
WSServiceDelegate owner,
Tube pipe,
BindingImpl binding,
WSEndpointReference epr)
public static Dispatch<Source> createSourceDispatch(WSPortInfo portInfo,
Service.Mode mode,
BindingImpl binding,
WSEndpointReference epr)
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||