| java.lang.Object
 com.sun.xml.ws.client.Stub
All known Subclasses: com.sun.xml.ws.client.sei.SEIStub, com.sun.xml.ws.client.dispatch.DispatchImpl,
| Stub | | abstract public class Stub implements WSBindingProvider,ResponseContextReceiver(Code) | | Base class for stubs, which accept method invocations from
client applications and pass the message to a
Tube for processing.
This class implements the management of pipe instances,
and most of the
BindingProvider methods.
author:
Kohsuke Kawaguchi |
| addrVersion | | final protected AddressingVersion addrVersion(Code) | | represents AddressingVersion on binding if enabled, otherwise null;
|
| endpointReference | | final protected WSEndpointReference endpointReference(Code) | | Non-null if this stub is configured to talk to an EPR.
When this field is non-null, its reference parameters are sent as out-bound headers.
This field can be null even when addressing is enabled, but if the addressing is
not enabled, this field must be null.
Unlike endpoint address, we are not letting users to change the EPR,
as it contains references to services and so on that we don't want to change.
|
| Stub | | protected Stub(WSServiceDelegate owner, Tube master, BindingImpl binding, WSDLPort wsdlPort, EndpointAddress defaultEndPointAddress, WSEndpointReference epr)(Code) | |
Parameters:
master - The created stub will send messages to this pipe.
Parameters:
binding - As a BindingProvider, this object willreturn this binding from BindingProvider.getBinding.
Parameters:
defaultEndPointAddress - The destination of the message. The actual destinationcould be overridden by RequestContext.
Parameters:
epr - To create a stub that sends out reference parametersof a specific EPR, give that instance. Otherwise null.Its address field will not be used, and that should be givenseparately as the defaultEndPointAddress. |
| close | | public void close()(Code) | | |
| getEndpointReference | | final public T getEndpointReference(Class<T> clazz)(Code) | | |
| getExecutor | | final public Executor getExecutor()(Code) | | Gets the
Executor to be used for asynchronous method invocations.
Note that the value this method returns may different from invocations
to invocations. The caller must not cache.
always non-null. |
| getPortName | | abstract protected QName getPortName()(Code) | | 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.
|
| getServiceName | | final protected QName getServiceName()(Code) | | Gets the service name that this stub is configured to talk to.
When
Stub.wsdlPort is non-null, the service name is always
the same as the one that's inferred from
WSDLPort.getOwner ,
but this method returns a port name even if no WSDL is available for
this stub.
|
| process | | final protected Packet process(Packet packet, RequestContext requestContext, ResponseContextReceiver receiver)(Code) | | Passes a message to a pipe for processing.
Unlike
Tube instances,
this method is thread-safe and can be invoked from
multiple threads concurrently.
Parameters:
packet - The message to be sent to the server
Parameters:
requestContext - The RequestContext when this invocation is originally scheduled.This must be the same object as Stub.requestContext for synchronousinvocations, but for asynchronous invocations, it needs to be a snapshotcaptured at the point of invocation, to correctly satisfy the spec requirement.
Parameters:
receiver - Receives the ResponseContext. Since the spec requiresthat the asynchronous invocations must not update response context,depending on the mode of invocation they have to go to different places.So we take a setter that abstracts that away. |
| processAsync | | final protected void processAsync(Packet request, RequestContext requestContext, Fiber.CompletionCallback completionCallback)(Code) | | Passes a message through a
Tube line for processing. The processing happens
asynchronously and when the response is available, Fiber.CompletionCallback is
called. The processing could happen on multiple threads.
Unlike
Tube instances,
this method is thread-safe and can be invoked from
multiple threads concurrently.
Parameters:
request - The message to be sent to the server
Parameters:
requestContext - The RequestContext when this invocation is originally scheduled.This must be the same object as Stub.requestContext for synchronousinvocations, but for asynchronous invocations, it needs to be a snapshotcaptured at the point of invocation, to correctly satisfy the spec requirement.
Parameters:
completionCallback - Once the processing is done, the callback is invoked. |
| setAddress | | final public void setAddress(String address)(Code) | | |
| setOutboundHeaders | | final public void setOutboundHeaders(List<Header> headers)(Code) | | |
| setOutboundHeaders | | final public void setOutboundHeaders(Header... headers)(Code) | | |
|
|