|
||||||||||
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 javax.jbi.component.ComponentContext given to the component during its initialization (see javax.jbi.component.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(javax.xml.namespace.QName serviceName,
javax.xml.namespace.QName operationName)
Creates a new MessageExchange instance used to initiate a service invocation. |
MessageExchange |
createExchange(java.net.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(javax.xml.namespace.QName serviceName, javax.xml.namespace.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(java.net.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
|
${build-info} | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |