|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.sun.xml.ws.rx.util.Communicator
public final class Communicator
Transmits standalone protocol messages over the wire. Provides also some additional
utility methods for creating and unmarshalling JAXWS Message and Header
objects.
WARNING: This class is a private utility class used by WS-RX implementation.
Any usage outside the intended scope is strongly discouraged. The API exposed
by this class may be changed, replaced or removed without any advance notice.
| Nested Class Summary | |
|---|---|
static class |
Communicator.Builder
|
| Field Summary | |
|---|---|
QName |
soapMustUnderstandAttributeName
|
| Method Summary | |
|---|---|
static Communicator.Builder |
builder(String name)
|
void |
close()
|
Packet |
createEmptyRequestPacket(boolean expectReply)
Creates a new empty request packet |
Packet |
createEmptyRequestPacket(String requestWsaAction,
boolean expectReply)
Creates a new empty request packet with an empty message that has WS-A action set |
Packet |
createEmptyResponsePacket(Packet requestPacket,
String responseWsaAction)
Creates an empty (no SOAP body payload) new response packet based for the supplied request packet with the provided response WS-Addressing action set. |
Packet |
createNullResponsePacket(Packet requestPacket)
Creates a null (no message) response packet based for the supplied request packet. |
Packet |
createRequestPacket(Message message,
String wsaAction,
boolean expectReply)
|
Packet |
createRequestPacket(Object jaxbElement,
String wsaAction,
boolean expectReply)
|
Packet |
createRequestPacket(Packet originalRequestPacket,
Object jaxbElement,
String wsaAction,
boolean expectReply)
|
Packet |
createResponsePacket(Packet requestPacket,
Message message,
String responseWsaAction)
Creates new response packet based for the supplied request packet with the provided response WS-Addressing action set. |
Packet |
createResponsePacket(Packet requestPacket,
Object jaxbElement,
String responseWsaAction,
boolean isClientResponse)
Creates new response packet based for the supplied request packet with the provided response WS-Addressing action set. |
AddressingVersion |
getAddressingVersion()
|
Component |
getContainer()
|
EndpointAddress |
getDestinationAddress()
Provides the destination endpoint reference this Communicator is pointing to. |
SOAPVersion |
getSoapVersion()
|
String |
getWsaAction(Packet packet)
Returns the value of WS-Addressing Action header of a message stored
in the Packet. |
String |
getWsaTo(Packet packet)
Returns the value of WS-Addressing To header of a message stored
in the Packet. |
boolean |
isClosed()
|
Packet |
send(Packet request)
Sends the request Packet and returns the corresponding response Packet. |
void |
sendAsync(Packet request,
Fiber.CompletionCallback completionCallbackHandler)
Asynchronously sends the request Packet |
void |
sendAsync(Packet request,
Fiber.CompletionCallback completionCallbackHandler,
FiberContextSwitchInterceptor interceptor)
|
void |
setDestinationAddress(EndpointAddress newValue)
|
void |
setDestinationAddressFrom(Packet packet)
|
Packet |
setEmptyRequestMessage(Packet request,
String wsaAction)
Creates a new JAX-WS Message object that doesn't have any payload
and sets it as the current packet content as a request message. |
Packet |
setEmptyResponseMessage(Packet response,
Packet request,
String wsaAction)
Overwrites the Message of the response packet with a newly created empty Message instance. |
SecurityTokenReferenceType |
tryStartSecureConversation(Packet request)
If security is enabled, tries to initate secured conversation and obtain the security token reference. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
public final QName soapMustUnderstandAttributeName
| Method Detail |
|---|
public static Communicator.Builder builder(String name)
public final Packet createRequestPacket(Object jaxbElement,
String wsaAction,
boolean expectReply)
public final Packet createRequestPacket(Message message,
String wsaAction,
boolean expectReply)
public final Packet createRequestPacket(Packet originalRequestPacket,
Object jaxbElement,
String wsaAction,
boolean expectReply)
public Packet createEmptyRequestPacket(boolean expectReply)
public Packet createEmptyRequestPacket(String requestWsaAction,
boolean expectReply)
public Packet createResponsePacket(@NotNull
Packet requestPacket,
Object jaxbElement,
String responseWsaAction,
boolean isClientResponse)
requestPacket - original request the newly created response belongs toresponseWsaAction - WS-Addressing action header value to be setisClientResponse - determines whether the response is technically a client request
public Packet createResponsePacket(Packet requestPacket,
Message message,
String responseWsaAction)
requestPacket - original request the newly created response belongs toresponseWsaAction - WS-Addressing action header value to be set
public Packet createEmptyResponsePacket(Packet requestPacket,
String responseWsaAction)
requestPacket - original request the newly created response belongs toresponseWsaAction - WS-Addressing action header value to be set
public Packet createNullResponsePacket(Packet requestPacket)
requestPacket - original request the newly created response belongs to
public final Packet setEmptyRequestMessage(Packet request,
String wsaAction)
Message object that doesn't have any payload
and sets it as the current packet content as a request message.
wsaAction - WS-Addressing action header to set
PacketAdapter instance
public final Packet setEmptyResponseMessage(Packet response,
Packet request,
String wsaAction)
Message of the response packet with a newly created empty Message instance.
Unlike Packet.setMessage(Message), this method fills in the Message's WS-Addressing headers
correctly, based on the provided request packet WS-Addressing headers.
requestAdapter - wsaAction -
public String getWsaAction(Packet packet)
Action header of a message stored
in the Packet.
packet - JAX-WS RI packet
Action header, null if the header is not presentpublic String getWsaTo(Packet packet)
To header of a message stored
in the Packet.
packet - JAX-WS RI packet
To header, null if the header is not present
public SecurityTokenReferenceType tryStartSecureConversation(Packet request)
throws WSTrustException
null if there is no SC configured
WSTrustException
public Packet send(@NotNull
Packet request)
Packet and returns the corresponding response Packet.
This method should be used for Req-Res MEP
request - Packet containing the message to be send
Message wrapped in a response Packet received
public void sendAsync(@NotNull
Packet request,
@Nullable
Fiber.CompletionCallback completionCallbackHandler)
Packet
request - Packet containing the message to be sendcompletionCallbackHandler - completion callback handler to process the response.
May be null. In such case a generic completion callback handler will be used.
public void sendAsync(@NotNull
Packet request,
@Nullable
Fiber.CompletionCallback completionCallbackHandler,
@Nullable
FiberContextSwitchInterceptor interceptor)
@Nullable public EndpointAddress getDestinationAddress()
Communicator is pointing to.
May return null (typically when used on the server side).
null in case the destination address has
not been specified when constructing this Communicator instance.public void setDestinationAddress(EndpointAddress newValue)
public void setDestinationAddressFrom(Packet packet)
public AddressingVersion getAddressingVersion()
public SOAPVersion getSoapVersion()
public void close()
public boolean isClosed()
public Component getContainer()
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||