|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface MessageExchangeFactory
A message exchange factory is used used to create new instances of
MessageExchange. Service consumers use these factories to create
message exchanges when initiating a new service request. Message
exchange factories are created using the
ComponentContext
given to the component
during its initialization (see
ComponentLifeCycle
). There are a variety
of ways to creating such factories, each of which creates a context
that is used to provide some of the default properties of
MessageExchange instances created by the factory instances. For example,
a factory can be created for a particular endpoint, ensuring that all exchanges
created by the factory have that endpoint set as the default endpoint property
of the exchange. This allows components to retain factories as a way of aligning
internal processing context with the context contained in the factory, ensuring
that the exchanges created consistently reflect that context.
Method Summary | |
---|---|
MessageExchange |
createExchange(QName serviceName,
QName operationName)
Creates a new MessageExchange instance used to initiate a service invocation. |
MessageExchange |
createExchange(URI pattern)
Creates a new MessageExchange instance used to initiate a service invocation. |
InOnly |
createInOnlyExchange()
Convenience method that creates an In-Only message exchange. |
InOptionalOut |
createInOptionalOutExchange()
Convenience method that creates an In-Optional-Out message exchange. |
InOut |
createInOutExchange()
Convenience method that creates an In-Out message exchange. |
RobustInOnly |
createRobustInOnlyExchange()
Convenience method that creates an Robust-In-Only message exchange. |
Method Detail |
---|
MessageExchange createExchange(QName serviceName, QName operationName) throws MessagingException
serviceName
- name of the service to be invokedoperationName
- name of the operation to be invoked
MessagingException
- if the given service or operation are not registered
with the NMR or the factory was created for a particular
interface, and the given serviceName does not implement
that interface.MessageExchange createExchange(URI pattern) throws MessagingException
pattern
- message exchange pattern
MessagingException
- specified pattern is not registered to a message exchange typeInOnly createInOnlyExchange() throws MessagingException
MessagingException
- failed to create exchangeInOptionalOut createInOptionalOutExchange() throws MessagingException
MessagingException
- failed to create exchangeInOut createInOutExchange() throws MessagingException
MessagingException
- failed to create exchangeRobustInOnly createRobustInOnlyExchange() throws MessagingException
MessagingException
- failed to create exchange
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |