Not intended to be used directly. See EmsTemplate.
+ +ConvertAndSend and ReceiveAndConvert operations.
+
+ Converts a String to a EMS TextMessage, a byte array to a EMS BytesMessage, + a Map to a EMS MapMessage, and a Serializable object to a EMS ObjectMessage + (or vice versa).
+ + +Lookup method whenever it is appropriate.
+ Some classes might do this on initialization, while others might do it
+ on demand. The latter strategy is more flexible in that it allows for
+ initialization of the locator before the JNDI object is available.
+ createEmsTemplate method.
+
+ To be used with the EmsTemplate.Execute(ISessionCallback)} + method, often implemented as an anonymous inner class.
+Session
+
+ Session, if any (so can be null)
+ Session.Close() call will also close the subscription.
+ Re-registering a durable consumer for the same subscription on the same
+ Session handle is not supported; close and reobtain a cached Session first.
+ null to indicate
+ creation of a raw standard Sessionfalse. Switch this to true
+ to automatically trigger recover based on your messaging provider's
+ exception notifications.
+ <listener-container> element.
+ + This method is never invoked if the parser is namespace aware + and was called to process the root node. +
+Default is "true"; set this to "false" to allow for manual startup.
+
+ Invoked after population of normal object properties but before an init
+ callback like
true; the default 'running'
+ state is purely determined by false if such a restriction prevents listeners from running.
+ finally blocks in manual EMS code.
+ null)
+
+ finally blocks in manual EMS code.
+ null)
+
+ whether to call stop() before closing
+
+ finally blocks in manual EMS code.
+ null)
+
+ finally blocks in manual EMS code.
+ null)
+
+ finally blocks in manual EMS code.
+ null)
+
+ finally blocks in manual EMS code.
+ null.
+ Session object to use
+
+ the EMS MessageProducer object to use
+
+ Session, if any (can be null)
+ Note: This is an SPI class, not intended to be used by applications.
+ +null)
+
+ null.)
+ String or byte array), it will get
+ wrapped in a EMS Message and sent to the response destination
+ (either the EMS "reply-to" destination or the null)null).
+ The original request message.
+ The session to operate on (may be null).
+ Message (never null)null
+ it is returned; if it is null, then the configured
+ null, then an
+ null)true if the domain is pub-sub, false if P2P
+
+ Message (never null)
+
+ Message to be sent
+ Implemented by EmsTemplate. Not often used but a useful option + to enhance testability, as it can easily be mocked or stubbed.
+ +Provides EmsTemplate's send(..) and
+ receive(..) methods that mirror various EMS API methods.
+ See the EMS specification and EMS API docs for details on those methods.
+
This will only work with a default destination specified!
+This will only work with a default destination specified!
+This will only work with a default destination specified!
+This will only work with a default destination specified!
+This will only work with a default destination specified!
+This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires.
+ null if none).
+ The action callback object that exposes the session/browser pair.
+ null if none).
+ The action callback object that exposes the session/browser pair.
+ null if none).
+ The action callback object that exposes the session/browser pair.
+ null if none).
+ The action callback delegate that exposes the session/browser pair.
+ null if none).
+ The action callback delegate that exposes the session/browser pair.
+ null if none).
+ The action callback delegate that exposes the session/browser pair.
+ execute(SessionCallback),
+ allowing the EMS Connection to be started on the fly.
+ Use execute(SessionCallback) for the general case.
+ Starting the EMS Connection is just necessary for receiving messages,
+ which is preferably achieved through the receive methods.
execute(SessionCallback),
+ allowing the EMS Connection to be started on the fly.
+ Use execute(SessionCallback) for the general case.
+ Starting the EMS Connection is just necessary for receiving messages,
+ which is preferably achieved through the receive methods.
null).
+ null if nonenull if none found
+ null if none found
+ Delegates to doCreateProducer for creation of the raw
+ EMS MessageProducer
null)
+
+ Note: The value of PubSubDomain affects the behavior of this method. + If PubSubDomain equals true, then a Session is passed to the callback. + If false, then a Session is passed to the callback.
+This will only work with a default destination specified!
+This will only work with a default destination specified!
+This will only work with a default destination specified!
+This will only work with a default destination specified!
+This will only work with a default destination specified!
+This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires
+ null
+ null if none.null if noneThis method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+This will only work with a default destination specified!
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires.
+ This method should be used carefully, since it will block the thread + until the message becomes available or until the timeout value is exceeded.
+null if none).
+ See the EMS specification for a detailed definition of selector expressions.
+
+ null if the timeout expires.
+ null if none).
+ The action callback object that exposes the session/browser pair.
+ null if none).
+ The action callback object that exposes the session/browser pair.
+ null if none).
+ The action callback object that exposes the session/browser pair.
+ null if none).
+ The action callback delegate that exposes the session/browser pair.
+ null if none).
+ The action callback delegate that exposes the session/browser pair.
+ null if none).
+ The action callback delegate that exposes the session/browser pair.
+ The default converter is a SimpleMessageConverter, which is able + to handle BytesMessages, TextMessages and ObjectMessages.
+DoGetTransactionalSession method.
+ null, the call will be ignored)
+ The ConnectionFactory that the Connection was obtained from. (may be null)
+ whether the Connection might have been started by the application.
+ null)
+
+ whether to allow for a local EMS transaction
+ that is synchronized with a Spring-managed transaction (where the main transaction
+ might be a ADO.NET-based one for a specific DataSource, for example), with the EMS
+ transaction committing right after the main transaction. If not allowed, the given
+ ConnectionFactory needs to handle transaction enlistment underneath the covers.
+
+ null if none found
+ false.
+ null if none found
+ DoGetTransactionalSession method.
+ null if none found
+ null if none found
+ The Session typically is provided by an instance + of the EmsTemplate class.
+Message (never null)
+
+ Message to be sent
+ OnMessage methodsnull
+ if the configured destination is not an actual Destination type;
+ c.f. null if the configured destination is not a
+ string type; c.f. null if none)..listener-container' tag.
+ true if the domain is pub-sub, false if P2P
+
+ IConnectionFactory interface,
+ indicating how to release Connections obtained from it.
+ To be used with the EmsTemplate.Execute(IProducerCallback) + method, often implemented as an anonymous inner class.
+ +The typical implementation will perform multiple operations on the + supplied EMS Session and MessageProducer.
+Session object to use
+
+ the EMS MessageProducer object to use
+
+ Session, if any (can be null)
+ Session, if any (so can be null)
+ ConnectionFactory. Binds a
+ Connection/Session pair from the specified ConnecctionFactory to the thread,
+ potentially allowing for one thread-bound Session per ConnectionFactory.
+