Spring.Messaging.Ems A Connection object is a client's active connection to TIBCO EMS Server. An interface containing all methods and properties on the TIBCO.EMS.Connection class. Refer to the TIBCO EMS API documentation for more information. Mark Pollack Closes the connection and reclaims resources. Creates the session. if set to true the session has transaction semantcis. Indicates whether and how the consumer is to acknowledge received messages. This version of CreateSession accepts an integer value associated with the acknowledge mode described by a Session member and should only be used for backward compatibility. This parameter is ignored if the session is transacted. A newly created session. Creates the session. if set to true [transacted]. The acknowledge mode. When true, the new session has transaction semantics. Indicates whether and how the consumer is to acknowledge received messages. Legal values are listed under SessionMode. This parameter is ignored if the session is transacted. A newly created session. Starts (or restarts) a connection's delivery of incoming messages. Temporarily stops a connection's delivery of incoming messages. A String representation of the connection object A that represents this instance. Gets the native TIBCO EMS connection. The native connection. Occurs when the client library detects a problem with the connection. Gets the URL of the server this connection is currently connected to The active URL. Gets or sets the client ID. The client ID. Gets the connection ID. The connection ID. Gets or sets the exception listener. The exception listener. Gets a value indicating whether the connection is closed. true if the connection is closed; otherwise, false. Gets a value indicating whether the connection communicates with a secure protocol true if the connection communicates with a secure protocol; otherwise, false. Gets the metadata for this connection The metadata for this connection. Initializes a new instance of the class. The underlying TIBCO EMS connection. Closes the connection and reclaims resources. Creates the session. if set to true the session has transaction semantcis. Indicates whether and how the consumer is to acknowledge received messages. This version of CreateSession accepts an integer value associated with the acknowledge mode described by a Session member and should only be used for backward compatibility. This parameter is ignored if the session is transacted. A newly created session. Creates the session. if set to true [transacted]. The acknowledge mode. When true, the new session has transaction semantics. Indicates whether and how the consumer is to acknowledge received messages. Legal values are listed under SessionMode. This parameter is ignored if the session is transacted. A newly created session. Starts (or restarts) a connection's delivery of incoming messages. Temporarily stops a connection's delivery of incoming messages. Gets the native TIBCO EMS connection. The native connection. Occurs when the client library detects a problem with the connection. Gets the URL of the server this connection is currently connected to The active URL. Gets or sets the client ID. The client ID. Gets the connection ID. The connection ID. Gets or sets the exception listener. The exception listener. Gets a value indicating whether the connection is closed. true if the connection is closed; otherwise, false. Gets a value indicating whether the connection communicates with a secure protocol true if the connection communicates with a secure protocol; otherwise, false. Gets the metadata for this connection The metadata for this connection. An interface containing all methods and properties on the TIBCO.EMS.ConnectionFactory class. Refer to the TIBCO EMS API documentation for more information. All the 'GetXXX()' methods in the TIBCO.EMS.ConnectionFactory were translated to .NET properties Mark Pollack Creates the connection. The newly created connection Creates the connection with the given username and password Name of the user. The password. Gets the native TIBCO EMS connection factory. The native connection factory. Gets the certificate store info object associated with this connection factory. The certificate store. Gets or sets the SSL proxy host. The SSL proxy host. Gets or sets the SSL proxy port. The SSL proxy port. Gets the SSL proxy password. The SSL proxy password. Gets the SSL proxy user. The SSL proxy user. Sets the type of the certificate store. The type of the certificate store. Sets the client ID. The client ID. Sets the client tracer to a given output stream The client tracer. Sets the number of connection attempts The number of connection attempts. Sets delay between connection attempts The delay between connection attempts. Sets the connection attempt timeout. The connection attempt timeout. Sets the custom host name verifier. Set to null to remove custom host name verifier. The host name verifier. Sets the load balance metric as an integer. The load balance metric as int. Sets the port on which the client will connect to the multicast daemon. The multicast daemon port. Sets whether MessageConsumers subscribed to a multicast-enabled topic will receive messages over multicast. true to enable multicast; false to disable. Gets or sets the the default length of time in milliseconds from its dispatch time that a produced message should be retained by the message system. Time to live is set to zero by default. The message time to live in milliseconds; zero is unlimited Market interface for EMS SSL store types Namespace parser for the EMS namespace. Mark Fisher Juergen Hoeller Mark Pollack (.NET) Register a MessageListenerContainer for the 'listener-container' tag. Parser for the EMS <listener-container> element. Mark Fisher Juergen Hoeller Mark Pollack (.NET) Parse the specified XmlElement and register the resulting ObjectDefinitions with the IObjectDefinitionRegistry embedded in the supplied The element to be parsed. TThe object encapsulating the current state of the parsing process. Provides access to a IObjectDefinitionRegistry The primary object definition.

This method is never invoked if the parser is namespace aware and was called to process the root node.

EMS MessageConsumer decorator that adapts all calls to a shared MessageConsumer instance underneath. Juergen Hoeller Mark Pollack (.NET) Initializes a new instance of the class. The target. Receives the next message produced for this message consumer. the next message produced for this message consumer, , or null if this message consumer is concurrently closed Receives the next message that arrives within the specified timeout interval. The timeout value. the next message produced for this message consumer, or null if the timeout expires or this message consumer is concurrently closed Receives the next message if one is immediately available. the next message produced for this message consumer, or null if one is not available No-op implementation since it is caching. Description that shows this is a cached MessageConsumer Description that shows this is a cached MessageConsumer Gets the target MessageConsumer, the consumer we are 'wrapping' The target MessageConsumer. Occurs when a message is received. MessageProducer decorator that adapts calls to a shared MessageProducer instance underneath, managing QoS settings locally within the decorator. Juergen Hoeller Mark Pollack (.NET) Initializes a new instance of the class. The target. Sends the specified message. The message. Sends the specified message. The message. The delivery mode. The priority. The time to live. Sends a message to the specified destination. The destination. The message. Reset properties. Returns string indicated this is a wrapped MessageProducer Gets or sets a value indicating whether disable setting of the message ID property. true if disable message ID setting; otherwise, false. Gets or sets a value indicating whether disable setting the message timestamp property. true if disable message timestamp; otherwise, false. Gets or sets the producer's default delivery mode. The message delivery mode for this message producer Gets or sets the MSG delivery mode. The MSG delivery mode. Gets or sets the priority of messages sent with this producer. The priority. Gets or sets the the default length of time in milliseconds from its dispatch time that a produced message should be retained by the message system. Time to live is set to zero by default. The message time to live in milliseconds; zero is unlimited Gets the target MessageProducer, the producer we are 'wrapping' The target MessageProducer. Wrapper for Session that caches producers and registers itself as available to the session cache when being closed. Generally used for testing purposes or if need to get at the wrapped Session object via the TargetSession property (for vendor specific methods). Juergen Hoeller Mark Pollack Subinterface of Session to be implemented by implementations that wrap an Session to provide added functionality. Allows access to the the underlying target Session. Mark Pollack Gets the target session of the decorator. This will typically be the native provider Session or a wrapper from a session pool. The underlying session, never null Initializes a new instance of the class. The target session. The session list. The CachingConnectionFactory. Creates the producer, potentially returning a cached instance. The destination. A message producer. If have not yet reached session cache size, cache the session, otherwise dispose of all cached message producers and close the session. Creates the consumer, potentially returning a cached instance. The destination. A message consumer Creates the consumer, potentially returning a cached instance. The destination. The selector. A message consumer Creates the consumer, potentially returning a cached instance. The destination. The selector. if set to true [no local]. A message consumer. Creates the durable consumer, potentially returning a cached instance. The destination. The name of the durable subscription. The selector. if set to true [no local]. A message consumer Creates the durable consumer, potentially returning a cached instance. The destination. The name of the durable subscription. A message consumer Creates the consumer. The destination. The selector. if set to true [no local]. The subscription. Gets the queue. The name. Gets the topic. The name. Creates the temporary queue. Creates the temporary topic. Creates the message. Creates the text message. Creates the text message. The text. Creates the map message. Creates the bytes message. Creates the object message. Creates the object message. The body. Creates the stream message. Commits this instance. Rollbacks this instance. Returns a that represents the current . A that represents the current . Gets the target, for testing purposes. The target. Gets a value indicating whether this is transacted. true if transacted; otherwise, false. Gets the acknowledgement mode. The acknowledgement mode. subclass that adds Session, MessageProducer, and MessageConsumer caching. This ConnectionFactory also switches the ReconnectOnException property to true by default, allowing for automatic recovery of the underlying Connection. By default, only one single Session will be cached, with further requested Sessions being created and disposed on demand. Consider raising the SessionCacheSize property in case of a high-concurrency environment. NOTE: This ConnectionFactory requires explicit closing of all Sessions obtained from its shared Connection. This is the usual recommendation for native EMS access code anyway. However, with this ConnectionFactory, its use is mandatory in order to actually allow for Session reuse. Note also that MessageConsumers obtained from a cached Session won't get closed until the Session will eventually be removed from the pool. This may lead to semantic side effects in some cases. For a durable subscriber, the logical 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. Juergen Hoeller Mark Pollack (.NET) A ConnectionFactory adapter that returns the same Connection from all CreateConnection() calls, and ignores calls to Connection.Close(). According to the JMS Connection model, this is perfectly thread-safe. The shared Connection can be automatically recovered in case of an Exception. You can either pass in a specific Connection directly or let this factory lazily create a Connection via a given target ConnectionFactory. Useful for testing and in applications when you want to keep using the same Connection for multiple calls, without having a pooling ConnectionFactory underneath. This may span any number of transactions, even concurrently executing transactions. Note that Spring's message listener containers support the use of a shared Connection within each listener container instance. Using SingleConnectionFactory with a MessageListenerContainer only really makes sense for sharing a single Connection across multiple listener containers. Juergen Hoeller Mark Pollack Mark Pollack (.NET) Wrapped Connection Proxy Connection Whether the shared Connection has been started Synchronization monitor for the shared Connection Initializes a new instance of the class. Initializes a new instance of the class that alwasy returns the given Connection. The single Connection. Initializes a new instance of the class that alwasy returns a single Connection. The target connection factory. Creates the connection. A single shared connection Creates the connection. Name of the user. The password. Initialize the underlying shared Connection. Closes and reinitializes the Connection if an underlying Connection is present already. Exception listener callback that renews the underlying single Connection. The exception from the messaging infrastructure. Prepares the connection before it is exposed. The default implementation applies ExceptionListener and client id. Can be overridden in subclasses. The Connection to prepare. if thrown by any EMS API methods. Template method for obtaining a (potentially cached) Session. The connection to operate on. The session ack mode. the Session to use, or null to indicate creation of a raw standard Session reate a JMS Connection via this template's ConnectionFactory. Closes the given connection. The connection. Ensure that the connection or TargetConnectionFactory are specified. Close the underlying shared connection. The provider of this ConnectionFactory needs to care for proper shutdown. As this object implements an application context will automatically invoke this on distruction o Resets the underlying shared Connection, to be reinitialized on next access. Wrap the given Connection with a proxy that delegates every method call to it but suppresses close calls. This is useful for allowing application code to handle a special framework Connection just like an ordinary Connection from a ConnectionFactory. The original connection to wrap. the wrapped connection Gets or sets the target connection factory which will be used to create a single connection. The target connection factory. Sets the exception listener. The exception listener. Gets or sets a value indicating whether the single Connection should be reset (to be subsequently renewed) when a EMSException is reported by the underlying Connection. Default is false. Switch this to true to automatically trigger recover based on your messaging provider's exception notifications. Internally, this will lead to a special ExceptionListener (this SingleConnectionFactory itself) being registered with the underlying Connection. This can also be combined with a user-specified ExceptionListener, if desired. true attempt to reconnect on exception during next access; otherwise, false. Gets the connection monitor. The connection monitor. Gets a value indicating whether this instance is started. true if this instance is started; otherwise, false. Gets the client id. The client id. Initializes a new instance of the class. and sets the ReconnectOnException to true Initializes a new instance of the class for the given IConnectionFactory The target connection factory. Resets the Session cache as well as resetting the connection. Obtaining a cached Session. The connection to operate on. The session ack mode. The Session to use Wraps the given Session so that it delegates every method call to the target session but adapts close calls. This is useful for allowing application code to handle a special framework Session just like an ordinary Session. The original Session to wrap. The List of cached Sessions that the given Session belongs to. The wrapped Session Gets or sets the size of the session cache. This cache size is the maximum limit for the number of cached Sessions per session acknowledgement type (auto, client, dups_ok, transacted). As a consequence, the actual number of cached Sessions may be up to four times as high as the specified value - in the unlikely case of mixing and matching different acknowledgement types. Default is 1: caching a single Session, (re-)creating further ones on demand. Specify a number like 10 if you'd like to raise the number of cached Sessions; that said, 1 may be sufficient for low-concurrency scenarios. The size of the session cache. Gets or sets a value indicating whether to cache MessageProducers per Session instance. (more specifically: one MessageProducer per Destination and Session). Default is "true". Switch this to "false" in order to always, recreate MessageProducers on demand. true if should cache message producers; otherwise, false. Gets or sets a value indicating whether o cache JMS MessageConsumers per EMS Session instance. Mmore specifically: one MessageConsumer per Destination, selector String and Session. Note that durable subscribers will only be cached until logical closing of the Session handle. Default is "true". Switch this to "false" in order to always recreate MessageConsumers on demand. true to cache consumers per session instance; otherwise, false. Gets or sets a value indicating whether this instance is active. true if this instance is active; otherwise, false. Implementation of Spring IExceptionListener interface that supports chaining allowing the addition of multiple ExceptionListener instances in order. Juergen Hoeller Mark Pollack (.NET) Adds the exception listener to the chain The listener. Called when an exception occurs in message processing. The exception. Gets the exception listeners as an array. The exception listeners. Helper class for obtaining transactional EMS resources for a given ConnectionFactory. Juergen Hoeller Mark Pollack (.NET) Releases the given connection, stopping it (if necessary) and eventually closing it. Checks , if available. This is essentially a more sophisticated version of The connection to release. (if this is 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. Return the innermost target Session of the given Session. If the given Session is a decorated session, it will be unwrapped until a non-decorated Session is found. Otherwise, the passed-in Session will be returned as-is. The session to unwrap The innermost target Session, or the passed-in one if no decorator Determines whether the given JMS Session is transactional, that is, bound to the current thread by Spring's transaction facilities. The session to check. The ConnectionFactory that the Session originated from true if is session transactional, bound to current thread; otherwise, false. Obtain a EMS Session that is synchronized with the current transaction, if any. the ConnectionFactory to obtain a Session for the existing EMS Connection to obtain a Session for (may be 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. the transactional Session, or null if none found EMSException in case of EMS failure Obtain a EMS Session that is synchronized with the current transaction, if any. the TransactionSynchronizationManager key to bind to (usually the ConnectionFactory) the ResourceFactory to use for extracting or creating EMS resources whether the underlying Connection approach should be started in order to allow for receiving messages. Note that a reused Connection may already have been started before, even if this flag is false. the transactional Session, or null if none found EMSException in case of EMS failure Callback interface for resource creation. Serving as argument for the DoGetTransactionalSession method. Fetch an appropriate Session from the given EmsResourceHolder. the EmsResourceHolder an appropriate Session fetched from the holder, or null if none found Fetch an appropriate Connection from the given EmsResourceHolder. the EmsResourceHolder an appropriate Connection fetched from the holder, or null if none found Create a new EMS Connection for registration with a EmsResourceHolder. the new EMS Connection EMSException if thrown by EMS API methods Create a new EMS Session for registration with a EmsResourceHolder. the EMS Connection to create a Session for the new EMS Session EMSException if thrown by EMS API methods Return 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 IDbProvider, for example), with the EMS transaction committing right after the main transaction. Returns whether to allow for synchronizing a local EMS transaction Callback for resource cleanup at the end of a non-native EMS transaction Connection holder, wrapping a EMS Connection and a EMS Session. EmsTransactionManager binds instances of this class to the thread, for a given EMS ConnectionFactory.

Note: This is an SPI class, not intended to be used by applications.

Juergen Hoeller Mark Pollack (.NET)
Create a new EmsResourceHolder that is open for resources to be added. Initializes a new instance of the class at is open for resources to be added. The connection factory that this resource holder is associated with (may be null) Initializes a new instance of the class for the given Session. The session. Create a new EmsResourceHolder for the given EMS resources. the EMS Connection the EMS Session Initializes a new instance of the class. The connection factory. The connection. The session. Adds the connection to the list of resources managed by this holder. The connection. Adds the session to the list of resources managed by this holder. The session. Adds the session and connection to the list of resources managed by this holder. The session. The connection. Gets the connection managed by this resource holder A Connection, or null if no managed connection. Gets the connection of a given type managed by this resource holder. This is used when storing Queue or Topic Connections (from the older 1.0.2 API) as compared to the 'unified domain' API , just Connection, in the newer 1.2 API. Type of the connection. The connection, or null if not found. Gets the first session manged by this holder or null if not available. The session or null if not available. Gets the session managed by this holder by type. Type of the session. The session or null if not available. Gets the session of a given type associated with the given connection Type of the session. The connection. The sessin or null if not available. Commits all sessions. Closes all sessions then stops and closes all connections, in that order. Determines whether the holder contains the specified session. The session. true if the holder contains the specified session; otherwise, false. Gets a value indicating whether this is frozen, namely that additional resources can be registered with the holder. If using any of the constructors with a Session, the holder will be set to the frozen state. true if frozen; otherwise, false. A implementation for a single EMS ConnectionFactory. Binds a Connection/Session pair from the specified ConnecctionFactory to the thread, potentially allowing for one thread-bound Session per ConnectionFactory. Application code is required to retrieve the transactional Session via . Spring's will autodetect a thread-bound Session and automatically participate in it. Transaction synchronization is turned off by default, as this manager might be used alongside an IDbProvider based Spring transaction manager such as the AdoPlatformTransactionManager, which has stronger needs for synchronization. Juergen Hoeller Mark Pollack (.NET) Initializes a new instance of the class. The ConnectionFactory has to be set before using the instance. This constructor can be used to prepare a EmsTemplate via a ApplicationContext, typically setting the ConnectionFactory via ConnectionFactory property. Turns off transaction synchronization by default, as this manager might be used alongside a dbprovider-based Spring transaction manager like AdoPlatformTransactionManager, which has stronger needs for synchronization. Only one manager is allowed to drive synchronization at any point of time. Initializes a new instance of the class given a ConnectionFactory. The connection factory to obtain connections from. Make sure the ConnectionFactory has been set. Get the EmsTransactionObject. he EmsTransactionObject. Begin a new transaction with the given transaction definition. Transaction object returned by . instance, describing propagation behavior, isolation level, timeout etc. Does not have to care about applying the propagation behavior, as this has already been handled by this abstract manager. In the case of creation or system errors. Suspend the resources of the current transaction. Transaction object returned by . An object that holds suspended resources (will be kept unexamined for passing it into .) Transaction synchronization will already have been suspended. in case of system errors. Resume the resources of the current transaction. Transaction object returned by . The object that holds suspended resources as returned by . Transaction synchronization will be resumed afterwards. In the case of system errors. Perform an actual commit on the given transaction. The status representation of the transaction. In the case of system errors. Perform an actual rollback on the given transaction. The status representation of the transaction. In the case of system errors. Set the given transaction rollback-only. Only called on rollback if the current transaction takes part in an existing one. The status representation of the transaction. In the case of system errors. Cleanup resources after transaction completion. Transaction object returned by . Called after and execution on any outcome. Check if the given transaction object indicates an existing transaction (that is, a transaction which has already started). Transaction object returned by . True if there is an existing transaction. In the case of system errors. Creates the connection via thie manager's ConnectionFactory. The new Connection If thrown by underlying messaging APIs Creates the session for the given Connection The connection to create a Session for. the new Session If thrown by underlying messaging APIs Gets or sets the connection factory that this instance should manage transaction. for. The connection factory. Gets the resource factory that this transaction manager operates on, In tihs case the ConnectionFactory The ConnectionFactory. EMS Transaction object, representing a EmsResourceHolder. Used as transaction object by EMSTransactionManager Extension of the IConnectionFactory interface, indicating how to release Connections obtained from it. Juergen Hoeller Mark Pollack (.NET) Shoulds we stop the connection, obtained from this ConnectionFactory? The connection to check. wheter a stop call is necessary Internal chained ExceptionListener for handling the internal recovery listener in combination with a user-specified listener. Add information to show this is a shared EMS connection Description of connection wrapper Exception thrown when a synchronized local transaction failed to complete (after the main transaction has already completed). Jergen Hoeller Mark Pollack (.NET) Creates a new instance of the SynchedLocalTransactionFailedException class. with the specified message. A message about the exception. Creates a new instance of the SynchedLocalTransactionFailedException class with the specified message and root cause. A message about the exception. The root exception that is being wrapped. Delegate callback for browsing the messages in an EMS queue. Convenient super class for application classes that need EMS access. Requires a ConnectionFactory or a EmsTemplate instance to be set. It will create its own EmsTemplate if a ConnectionFactory is passed in. A custom EmsTemplate instance can be created for a given ConnectionFactory through overriding the createEmsTemplate method. Creates a EmsTemplate for the given ConnectionFactory. Only invoked if populating the gateway with a ConnectionFactory reference. Can be overridden in subclasses to provide a different EmsTemplate instance The connection factory. Ensures that the JmsTemplate is specified and calls . Subclasses can override this for custom initialization behavior. Gets called after population of this instance's properties. Gets or sets the EMS template for the gateway. The EMS template. Gets or sets he EMS connection factory to be used by the gateway. Will automatically create a EmsTemplate for the given ConnectionFactory. The connection factory. Helper class that simplifies EMS access code. If you want to use dynamic destination creation, you must specify the type of EMS destination to create, using the "pubSubDomain" property. For other operations, this is not necessary. Point-to-Point (Queues) is the default domain. Default settings for EMS Sessions is "auto-acknowledge". This template uses a DynamicDestinationResolver and a SimpleMessageConverter as default strategies for resolving a destination name or converting a message, respectively. Mark Pollack Juergen Hoeller Mark Pollack (.NET) Base class for EmsTemplate} and other EMS-accessing gateway helpers, adding destination-related properties to EmsAccessor's common properties.

Not intended to be used directly. See EmsTemplate.

Juergen Hoeller Mark Pollack (.NET)
Base class for EmsTemplate and other EMS-accessing gateway helpers It defines common properties like the ConnectionFactory}. The subclass EmsDestinationAccessor adds further, destination-related properties. Not intended to be used directly. See EmsTemplate. Juergen Hoeller Mark Pollack (.NET) Verify that ConnectionFactory property has been set. Creates the connection via the ConnectionFactory. Creates the session for the given Connection The connection to create a session for. The new session Returns whether the Session is in client acknowledgement mode. The session to check. true if in client ack mode, false otherwise Gets or sets the connection factory to use for obtaining EMS Connections. The connection factory. Gets or sets the session acknowledge mode for EMS Sessions including whether or not the session is transacted Set the EMS acknowledgement mode that is used when creating a EMS Session to send a message. The default is AUTO_ACKNOWLEDGE. The session acknowledge mode. Set the transaction mode that is used when creating a EMS Session. Default is "false". Setting this flag to "true" will use a short local EMS transaction when running outside of a managed transaction, and a synchronized local EMS transaction in case of a managed transaction being present. The latter has the effect of a local EMS transaction being managed alongside the main transaction (which might be a native ADO.NET transaction), with the EMS transaction committing right after the main transaction. Resolves the given destination name to a EMS destination. The current session. Name of the destination. The located Destination If resolution failed. Gets or sets the destination resolver that is to be used to resolve Destination references for this accessor. The default resolver is a DynamicDestinationResolver. Specify a JndDestinationResolver for resolving destination names as JNDI locations. The destination resolver. Gets or sets a value indicating whether Publish/Subscribe domain (Topics) is used. Otherwise, the Point-to-Point domain (Queues) is used. this setting tells what type of destination to create if dynamic destinations are enabled. true if Publish/Subscribe domain; otherwise, false for the Point-to-Point domain. Specifies a basic set of EMS operations.

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.

Mark Pollack Juergen Hoeller Mark Pollack (.NET)
Execute the action specified by the given action object within a EMS Session. delegate that exposes the session the result object from working with the session If there is any problem accessing the EMS API Execute the action specified by the given action object within a EMS Session. callback object that exposes the session the result object from working with the session If there is any problem accessing the EMS API Send a message to a EMS destination. The callback gives access to the EMS session and MessageProducer in order to do more complex send operations. callback object that exposes the session/producer pair the result object from working with the session EMSException if there is any problem Send a message to a EMS destination. The callback gives access to the EMS session and MessageProducer in order to do more complex send operations. delegate that exposes the session/producer pair the result object from working with the session If there is any problem accessing the EMS API Send a message to the default destination.

This will only work with a default destination specified!

callback to create a message If there is any problem accessing the EMS API
Send a message to the specified destination. The IMessageCreator callback creates the message given a Session. the destination to send this message to callback to create a message If there is any problem accessing the EMS API Send a message to the specified destination. The IMessageCreator callback creates the message given a Session. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) callback to create a message If there is any problem accessing the EMS API Send a message to the default destination.

This will only work with a default destination specified!

delegate callback to create a message If there is any problem accessing the EMS API
Send a message to the specified destination. The IMessageCreator callback creates the message given a Session. the destination to send this message to delegate callback to create a message If there is any problem accessing the EMS API Send a message to the specified destination. The IMessageCreator callback creates the message given a Session. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) delegate callback to create a message If there is any problem accessing the EMS API Send the given object to the default destination, converting the object to a EMS message with a configured IMessageConverter.

This will only work with a default destination specified!

the object to convert to a message If there is any problem accessing the EMS API
Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. the destination to send this message to the object to convert to a message If there is any problem accessing the EMS API Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the object to convert to a message If there is any problem accessing the EMS API Send the given object to the default destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion.

This will only work with a default destination specified!

the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API
Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the destination to send this message to the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the object to convert to a message. the callback to modify the message If there is any problem accessing the EMS API Send the given object to the default destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion.

This will only work with a default destination specified!

the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API
Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the destination to send this message to the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the object to convert to a message. the callback to modify the message If there is any problem accessing the EMS API Receive a message synchronously from the default destination, but only wait up to a specified time for delivery.

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!

the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the default destination, but only wait up to a specified time for delivery.

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!

the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the default destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

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!

the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the default destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

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!

the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Browses messages in the default EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The action callback object that exposes the session/browser pair. the result object from working with the session If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The action callback object that exposes the session/browser pair. the result object from working with the session If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The EMS message selector expression (or null if none). The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The EMS message selector expression (or null if none). The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The EMS message selector expression (or null if none). The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in the default EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The action callback delegate that exposes the session/browser pair. the result object from working with the session Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The action callback delegate that exposes the session/browser pair. the result object from working with the session Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The EMS message selector expression (or null if none). The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The EMS message selector expression (or null if none). The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The EMS message selector expression (or null if none). The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Timeout value indicating that a receive operation should check if a message is immediately available without blocking. Create a new EmsTemplate. Note: The ConnectionFactory has to be set before using the instance. This constructor can be used to prepare a EmsTemplate via an ObjectFactory, typically setting the ConnectionFactory. Create a new EmsTemplate, given a ConnectionFactory. the ConnectionFactory to obtain Connections from Initialize the default implementations for the template's strategies: DynamicDestinationResolver and SimpleMessageConverter. Execute the action specified by the given action object within a EMS Session. Generalized version of 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.

callback object that exposes the session Start the connection before performing callback action. the result object from working with the session If there is any problem accessing the EMS API
Execute the action specified by the given action object within a EMS Session. Generalized version of 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.

callback object that exposes the session Start the connection before performing callback action. the result object from working with the session If there is any problem accessing the EMS API
Extract the content from the given JMS message. The Message to convert (can be null). The content of the message, or null if none Fetch an appropriate Connection from the given EmsResourceHolder. the EmsResourceHolder an appropriate Connection fetched from the holder, or null if none found Fetch an appropriate Session from the given EmsResourceHolder. the EmsResourceHolder an appropriate Session fetched from the holder, or null if none found Create a EMS MessageProducer for the given Session and Destination, configuring it to disable message ids and/or timestamps (if necessary).

Delegates to doCreateProducer for creation of the raw EMS MessageProducer

the EMS Session to create a MessageProducer for the EMS Destination to create a MessageProducer for the new EMS MessageProducer If there is any problem accessing the EMS API
Determines whether the given Session is locally transacted, that is, whether its transaction is managed by this template class's Session handling and not by an external transaction coordinator. The Session's own transacted flag will already have been checked before. This method is about finding out whether the Session's transaction is local or externally coordinated. The session to check. true if the session is locally transacted; otherwise, false. Create a raw EMS MessageProducer for the given Session and Destination. If CacheJmsResource is true, then the producer will be created upon the first invocation and will retrun the same producer (per destination) on all subsequent calls. the EMS Session to create a MessageProducer for the EMS Destination to create a MessageProducer for the new EMS MessageProducer If there is any problem accessing the EMS API Create a EMS MessageConsumer for the given Session and Destination. the EMS Session to create a MessageConsumer for the EMS Destination to create a MessageConsumer for the message selector for this consumer (can be null) the new EMS MessageConsumer If there is any problem accessing the EMS API Send the given message. The session to operate on. The destination to send to. The message creator delegate callback to create a Message. Send the given message. The session to operate on. The destination to send to. The message creator callback to create a Message. Send the given EMS message. the EMS Session to operate on the EMS Destination to send to callback to create a EMS Message delegate callback to create a EMS Message If there is any problem accessing the EMS API Actually send the given EMS message. the EMS MessageProducer to send with the EMS Message to send If there is any problem accessing the EMS API Execute the action specified by the given action object within a EMS Session. delegate that exposes the session the result object from working with the session Note that 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.b If there is any problem accessing the EMS API Execute the action specified by the given action object within a EMS Session.

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.

callback object that exposes the session the result object from working with the session If there is any problem accessing the EMS API
Send a message to a EMS destination. The callback gives access to the EMS session and MessageProducer in order to do more complex send operations. callback object that exposes the session/producer pair the result object from working with the session If there is any problem accessing the EMS API Send a message to a EMS destination. The callback gives access to the EMS session and MessageProducer in order to do more complex send operations. delegate that exposes the session/producer pair the result object from working with the session If there is any problem accessing the EMS API Send a message to the default destination.

This will only work with a default destination specified!

delegate callback to create a message If there is any problem accessing the EMS API
Send a message to the specified destination. The MessageCreator callback creates the message given a Session. the destination to send this message to delegate callback to create a message If there is any problem accessing the EMS API Send a message to the specified destination. The MessageCreator callback creates the message given a Session. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) delegate callback to create a message If there is any problem accessing the EMS API Send a message to the default destination.

This will only work with a default destination specified!

callback to create a message If there is any problem accessing the EMS API
Send a message to the specified destination. The MessageCreator callback creates the message given a Session. the destination to send this message to callback to create a message If there is any problem accessing the EMS API Send a message to the specified destination. The MessageCreator callback creates the message given a Session. the destination to send this message to callback to create a message If there is any problem accessing the EMS API Send the given object to the default destination, converting the object to a EMS message with a configured IMessageConverter.

This will only work with a default destination specified!

the object to convert to a message If there is any problem accessing the EMS API
Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. the destination to send this message to the object to convert to a message If there is any problem accessing the EMS API Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the object to convert to a message If there is any problem accessing the EMS API Send the given object to the default destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion.

This will only work with a default destination specified!

the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API
Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the destination to send this message to the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the object to convert to a message. the callback to modify the message If there is any problem accessing the EMS API Send the given object to the default destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion.

This will only work with a default destination specified!

the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API
Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the destination to send this message to the object to convert to a message the callback to modify the message If there is any problem accessing the EMS API Send the given object to the specified destination, converting the object to a EMS message with a configured IMessageConverter. The IMessagePostProcessor callback allows for modification of the message after conversion. the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the object to convert to a message. the callback to modify the message If there is any problem accessing the EMS API Receive a message synchronously from the default destination, but only wait up to a specified time for delivery.

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!

the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the default destination, but only wait up to a specified time for delivery.

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!

the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message received by the consumer, or null if the timeout expires If there is any problem accessing the EMS API
Receive a message. The session to operate on. The destination to receive from. The message selector for this consumer (can be null The Message received, or null if none. Receive a message. The session to operate on. The consumer to receive with. The Message received, or null if none Receive a message synchronously from the default destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

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!

the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the default destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

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!

the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the destination to receive a message from the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Receive a message synchronously from the specified destination, but only wait up to a specified time for delivery. Convert the message into an object with a configured IMessageConverter.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

the name of the destination to send this message to (to be resolved to an actual destination by a DestinationResolver) the EMS message selector expression (or null if none). See the EMS specification for a detailed definition of selector expressions. the message produced for the consumer or null if the timeout expires. If there is any problem accessing the EMS API
Browses messages in the default EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The action callback object that exposes the session/browser pair. the result object from working with the session If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The action callback object that exposes the session/browser pair. the result object from working with the session If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The EMS message selector expression (or null if none). The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The EMS message selector expression (or null if none). The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The EMS message selector expression (or null if none). The action callback object that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in the default EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The action callback delegate that exposes the session/browser pair. the result object from working with the session Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The action callback delegate that exposes the session/browser pair. the result object from working with the session Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The EMS message selector expression (or null if none). The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. The queue to browse. The EMS message selector expression (or null if none). The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Browses messages in a EMS queue. The callback gives access to the EMS Session and QueueBrowser in order to browse the queue and react to the contents. Name of the queue to browse, (to be resolved to an actual destination by a DestinationResolver) The EMS message selector expression (or null if none). The action callback delegate that exposes the session/browser pair. If there is any problem accessing the EMS API Creates the queue browser. The session. The queue. The selector. A new queue browser Gets or sets the default destination to be used on send/receive operations that do not have a destination parameter. Alternatively, specify a "defaultDestinationName", to be dynamically resolved via the DestinationResolver. The default destination. Gets or sets the name of the default destination name to be used on send/receive operations that do not have a destination parameter. Alternatively, specify a EMS Destination object as "DefaultDestination" The name of the default destination. Gets or sets the message converter for this template. Used to resolve Object parameters to convertAndSend methods and Object results from receiveAndConvert methods.

The default converter is a SimpleMessageConverter, which is able to handle BytesMessages, TextMessages and ObjectMessages.

The message converter.
Gets or sets a value indicating whether Message Ids are enabled. true if message id enabled; otherwise, false. Gets or sets a value indicating whether message timestamps are enabled. true if [message timestamp enabled]; otherwise, false. Gets or sets a value indicating whether to inhibit the delivery of messages published by its own connection. true if inhibit the delivery of messages published by its own connection; otherwise, false. Gets or sets the receive timeout to use for recieve calls. The default is -1, which means no timeout. The receive timeout. Gets or sets a value indicating whether to use explicit Quality of Service values. If "true", then the values of deliveryMode, priority, and timeToLive will be used when sending a message. Otherwise, the default values, that may be set administratively, will be used true if use explicit QoS values; otherwise, false. Sets a value indicating the delivery mode QOS This will set the delivery to persistent, non-persistent, or reliable delivery. Default value is Message.DEFAULT_DELIVERY_MODE (aka TIBCO.EMS.DeliveryMode.PERSISTENT) Integer value representing the delivery mode [delivery persistent]; otherwise, false. Gets or sets the priority when sending. Since a default value may be defined administratively, this is only used when "isExplicitQosEnabled" equals "true". The priority. Gets or sets the time to live when sending Since a default value may be defined administratively, this is only used when "isExplicitQosEnabled" equals "true". The time to live. ResourceFactory implementation that delegates to this template's callback methods. Callback for executing any number of operations on a provided Session

To be used with the EmsTemplate.Execute(ISessionCallback)} method, often implemented as an anonymous inner class.

Mark Pollack
Execute any number of operations against the supplied EMS Session, possibly returning a result. the EMS Session a result object from working with the Session, if any (so can be null) EMSException if there is any problem Creates a EMS message given a Session

The Session typically is provided by an instance of the EmsTemplate class.

Mark Pollack
Create a Message to be sent. the EMS Session to be used to create the Message (never null) the Message to be sent EMSException if thrown by EMS API methods This is a TIBCO specific class so that we can reuse connections, session, and message producers instead of creating/destroying them on each operation. Callback for browsing the messages in an EMS queue. To be used with EmsTemplate's callback methods that take a IBrowserCallback argument Juergen Hoeller Mark Pollack (.NET) Perform operations on the given Session and QueueBrowser The session. The browser. The object from working with the Session and QueueBrowser, may be null If there is any problem when accessing EMS API To be used with EmsTemplate's send method that convert an object to a message. It allows for further modification of the message after it has been processed by the converter. This is useful for setting of EMS Header and Properties. Mark Pollack Apply a IMessagePostProcessor to the message. The returned message is typically a modified version of the original. the EMS message from the IMessageConverter the modified version of the Message EMSException if thrown by EMS API methods Callback for sending a message to a EMS destination.

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.

Mark Pollack
Perform operations on the given Session and MessageProducer. The message producer is not associated with any destination. the EMS Session object to use the EMS MessageProducer object to use a result object from working with the Session, if any (can be null) Delegate that creates a EMS message given a Session the EMS Session to be used to create the Message (never null) the Message to be sent EMSException if thrown by EMS API methods Delegate that is used with EmsTemplate's ConvertAndSend method that converts an object. It allows for further modification of the message after it has been processed by the converter. This is useful for setting of EMS Header and Properties. Mark Pollack Perform operations on the given Session and MessageProducer. The message producer is not associated with any destination. the EMS Session object to use the EMS MessageProducer object to use a result object from working with the Session, if any (can be null) Callback delegate for code that operates on a Session. The EMS Session object. Allows you to execute any number of operations on a single ISession, possibly returning a result a result. A result object from working with the Session, if any (so can be null) EMSException if there is any problem Mark Pollack Convenient superclass to access JndiProperties, JndiContextType or alternatively set the ILookupContext directly. Juergen Hoeller Mark Pollack Create the JndiLookupContext if it has not been explicitly set. Gets or sets the lookup context. The lookup context. Gets or sets the JNDI environment properties. The jndi properties. Gets or sets the type of the jndi context. The default is JndiContextType.JMS The type of the jndi context. The various JNDI Context types. Create a tibjmsnaming context to lookup administered object inside the tibjmsnaming server. Create a ldap context to lookup administered object in an ldap server. Convenient superclass for JNDI-based service locators, providing configurable lookup of a specific JNDI resource. Exposes a JndiName property. Subclasses may invoke the 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. Juergen Hoeller Mark Pollack (.NET) Ensure that the JndiName property is set and create the TIBCO EMS ILookupContext instance. Lookups this instance using the JndiName and ExpectedType properties The object retrieved from Jndi Gets or sets the Jndi name to lookup. The name of the jndi. Gets or sets the type that the located JNDI object is supposed to be assignable to, if any. The expected type. Return the Jndi object The Jndi object Sets the default object to fall back to if the JNDI lookup fails. Default is none. This can be an arbitrary bean reference or literal value. It is typically used for literal values in scenarios where the JNDI environment might define specific config settings but those are not required to be present. The default object to use when lookup fails. Return type of object retrieved from Jndi or the expected type if the Jndi retrieval did not succeed. Return value of retrieved object Returns true Gets the template object definition that should be used to configure the instance of the object managed by this factory. A Spring FactoryObject that returns TIBCO.EMS.ILookupContext. Use the returned ILookupContext to do you lookups at runtime. Important properties to set are JndiProperties and JndiContexType. JndiContextType is set to LookupContextFactory.TIBJMS_NAMING_CONT by default. To lookup objects at startup time and cache their values, as well as provide a default value if lookup fail, Mark Pollack Returns the TIBCO.EMS.ILookupContext TIBCO.EMS.ILookupContext Return typeof(TIBCO.EMS.ILookupContext) Returns true Exception thrown if a type mismatch is encountered for an object located in a JNDI environment. Juergen Hoeller Mark Pollack (.NET) Creates a new instance of the class. A message about the exception. Initializes a new instance of the class building an explanation text from the given arguments. The Jndi name. Type required type of the lookup. The actual type that the lookup returned. Gets the actual type that the lookup returned, if available. The actual type that the lookup. Gets the required type for the lookup, if available. The equired type for the lookup Exception to be thrown when the execution of a listener method failed. Juergen Hoeller Mark Pollack (.NET) Initializes a new instance of the class, with the specified message The message. Initializes a new instance of the class, with the specified message and root cause exception The message. The inner exception. Message listener adapter that delegates the handling of messages to target listener methods via reflection, with flexible message type conversion. Allows listener methods to operate on message content types, completely independent from the EMS API. By default, the content of incoming messages gets extracted before being passed into the target listener method, to let the target method operate on message content types such as String or byte array instead of the raw Message. Message type conversion is delegated to a Spring . By default, a will be used. (If you do not want such automatic message conversion taking place, then be sure to set the property to null.) If a target listener method returns a non-null object (typically of a message content type such as 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 specified. The sending of response messages is only available when using the entry point (typically through a Spring message listener container). Usage as standard EMS MessageListener does not support the generation of response messages. Consult the reference documentation for examples of method signatures compliant with this adapter class. Juergen Hoeller Mark Pollack (.NET) Variant of the standard EMS MessageListener interface, offering not only the received Message but also the underlying Session object. The latter can be used to send reply messages, without the need to access an external Connection/Session, i.e. without the need to access the underlying ConnectionFactory. Supported by Spring's as direct alternative to the standard MessageListener interface. Juergen Hoeller Mark Pollack (.NET) Callback for processing a received EMS message. Implementors are supposed to process the given Message, typically sending reply messages through the given Session. the received EMS message the underlying EMS Session EMSException if thrown by EMS methods The default handler method name. Initializes a new instance of the class with default settings. Initializes a new instance of the class for the given handler object The delegate object. Standard JMS {@link MessageListener} entry point. Delegates the message to the target listener method, with appropriate conversion of the message arguments In case of an exception, the method will be invoked. Note Does not support sending response messages based on result objects returned from listener methods. Use the entry point (typically through a Spring message listener container) for handling result objects as well. The incoming message. Spring entry point. Delegates the message to the target listener method, with appropriate conversion of the message argument. If the target method returns a non-null object, wrap in a EMS message and send it back. The incoming message. The session to operate on. Initialize the default implementations for the adapter's strategies. Handle the given exception that arose during listener execution. The default implementation logs the exception at error level. This method only applies when used as standard EMS MessageListener. In case of the Spring mechanism, exceptions get handled by the caller instead. The exception to handle. Extract the message body from the given message. The message. the content of the message, to be passed into the listener method as argument if thrown by EMS API methods Gets the name of the listener method that is supposed to handle the given message. The default implementation simply returns the configured default listener method, if any. The EMS request message. The converted JMS request message, to be passed into the listener method as argument. the name of the listener method (never null) if thrown by EMS API methods Handles the given result object returned from the listener method, sending a response message back. The result object to handle (never null). The original request message. The session to operate on (may be null). Builds a JMS message to be sent as response based on the given result object. The JMS Session to operate on. The content of the message, as returned from the listener method. the JMS Message (never null) If there was an error in message conversion if thrown by EMS API methods Post-process the given response message before it will be sent. The default implementation sets the response's correlation id to the request message's correlation id. The original incoming message. The outgoing JMS message about to be sent. if thrown by EMS API methods Determine a response destination for the given message. The default implementation first checks the JMS Reply-To Destination of the supplied request; if that is not null it is returned; if it is null, then the configured default response destination} is returned; if this too is null, then an is thrown. The original incoming message. Tthe outgoing message about to be sent. The session to operate on. the response destination (never null) if thrown by EMS API methods if no destination can be determined. Resolves the default response destination into a Destination, using this accessor's in case of a destination name. The session to operate on. The located destination Sends the given response message to the given destination. The session to operate on. The destination to send to. The outgoing message about to be sent. Post-process the given message producer before using it to send the response. The default implementation is empty. The producer that will be used to send the message. The outgoing message about to be sent. Gets or sets the handler object to delegate message listening to. Specified listener methods have to be present on this target object. If no explicit handler object has been specified, listener methods are expected to present on this adapter instance, that is, on a custom subclass of this adapter, defining listener methods. The handler object. Gets or sets the default handler method to delegate to, for the case where no specific listener method has been determined. Out-of-the-box value is ("HandleMessage"}. The default handler method. Sets the default destination to send response messages to. This will be applied in case of a request message that does not carry a "JMSReplyTo" field. Response destinations are only relevant for listener methods that return result objects, which will be wrapped in a response message and sent to a response destination. Alternatively, specify a "DefaultResponseQueueName" or "DefaultResponseTopicName", to be dynamically resolved via the DestinationResolver. The default response destination. Sets the name of the default response queue to send response messages to. This will be applied in case of a request message that does not carry a "EMSReplyTo" field. Alternatively, specify a JMS Destination object as "defaultResponseDestination". The name of the default response destination queue. Sets the name of the default response topic to send response messages to. This will be applied in case of a request message that does not carry a "ReplyTo" field. Alternatively, specify a JMS Destination object as "defaultResponseDestination". The name of the default response destination topic. Gets or sets the destination resolver that should be used to resolve response destination names for this adapter. The default resolver is a . Specify another implementation, for other strategies, perhaps from a directory service. The destination resolver. Gets or sets the message converter that will convert incoming JMS messages to listener method arguments, and objects returned from listener methods back to EMS messages. The default converter is a {@link SimpleMessageConverter}, which is able to handle BytesMessages}, TextMessages, MapMessages, and ObjectMessages. The message converter. Internal class combining a destination name and its target destination type (queue or topic). Common base class for all containers which need to implement listening based on a Connection (either shared or freshly obtained for each attempt). Inherits basic Connection and Session configuration handling from the base class. This class provides basic lifecycle management, in particular management of a shared Connection. Subclasses are supposed to plug into this lifecycle, implementing the as well as Mark Pollack The monitor object to lock on when performing operations on the connection. The monitor object to lock on when performing operations that update the lifecycle of the container. Call base class method, then and then Validates the configuration of this container. The default implementation is empty. To be overriden in subclasses. Calls when the application context destroys the container instance. Initializes this container. Creates a Connection, starts the Connection (if the property hasn't been turned off), and calls . If startup failed Stop the shared connection, call , and close this container. Starts this container. if starting failed. Start the shared Connection, if any, and notify all invoker tasks. Stops this container. if stopping failed. Notify all invoker tasks and stop the shared Connection, if any. if thrown by EMS API methods. Register any invokers within this container. Subclasses need to implement this method for their specific invoker management process. A shared Connection, if any, will already have been started at this point. Close the registered invokers. Subclasses need to implement this method for their specific invoker management process. A shared Connection, if any, will automatically be closed afterwards. Establishes a shared Connection for this container. The default implementation delegates to which does one immediate attempt and throws an exception if it fails. Can be overridden to have a recovery process in place, retrying until a Connection can be successfully established. If thrown by EMS API methods Refreshes the shared connection that this container holds. Called on startup and also after an infrastructure exception that occurred during invoker setup and/or execution. If thrown by EMS API methods Creates the shared connection for this container. The default implementation creates a standard Connection and prepares it through the prepared Connection if the creation failed. Prepares the given connection, which is about to be registered as shared Connection for this container. The default implementation sets the specified client id, if any. Subclasses can override this to apply further settings. The connection to prepare. If the preparation efforts failed. Starts the shared connection. If thrown by EMS API methods Stops the shared connection. if thrown by EMS API methods. Gets or sets the client id for a shared Connection created and used by this container. Note that client ids need to be unique among all active Connections of the underlying JMS provider. Furthermore, a client id can only be assigned if the original ConnectionFactory hasn't already assigned one. The client id. Set whether to automatically start the listener after initialization.

Default is "true"; set this to "false" to allow for manual startup.

Set the name of the object in the object factory that created this object. The name of the object in the factory.

Invoked after population of normal object properties but before an init callback like 's method or a custom init-method.

Gets a value indicating whether this container is currently running, that is, whether it has been started and not stopped yet. true if this container is running; otherwise, false. Gets a value indicating whether this container's listeners are generally allowed to run. >This implementation always returns true; the default 'running' state is purely determined by /. Subclasses may override this method to check against temporary conditions that prevent listeners from actually running. In other words, they may apply further restrictions to the 'running' state, returning false if such a restriction prevents listeners from running. true if running allowed; otherwise, false. Gets a value indicating whether this container is currently active, that is, whether it has been set up but not shut down yet. true if active; otherwise, false. Return whether a shared EMS Connection should be maintained by this listener container base class. Gets the shared connection maintained by this container. Available after initialization. The shared connection (never null) if this container does not maintain a shared Connection, or if the Connection hasn't been initialized yet. Exception that indicates that the initial setup of this container's shared Connection failed. This is indicating to invokers that they need to establish the shared Connection themselves on first access. Initializes a new instance of the class. The message. Abstract base class for message listener containers. Can either host a standard EMS MessageListener or a Spring-specific Validate that the destination is not null and that if the subscription is durable, then we are not using the Pub/Sub domain. Executes the specified listener, committing or rolling back the transaction afterwards (if necessary). The session to operate on. The received message. Executes the specified listener, committing or rolling back the transaction afterwards (if necessary). The session to operate on. The received message. If thrown by EMS API methods. Invokes the specified listener: either as standard EMS MessageListener or (preferably) as Spring ISessionAwareMessageListener. The session to operate on. The received message. If thrown by EMS API methods. Invoke the specified listener as Spring ISessionAwareMessageListener, exposing a new EMS Session (potentially with its own transaction) to the listener if demanded. The Spring ISessionAwareMessageListener to invoke. The session to operate on. The received message. If thrown by EMS API methods. Invoke the specified listener as standard JMS MessageListener. Default implementation performs a plain invocation of the OnMessage methods The listener to invoke. The received message. if thrown by the EMS API methods Perform a commit or message acknowledgement, as appropriate The session to commit. The message to acknowledge. In case of commit failure Determines whether the given Session is locally transacted, that is, whether its transaction is managed by this listener container's Session handling and not by an external transaction coordinator. The Session's own transacted flag will already have been checked before. This method is about finding out whether the Session's transaction is local or externally coordinated. The session to check. true if the is session locally transacted; otherwise, false. Perform a rollback, if appropriate. The session to rollback. In case of a rollback error Perform a rollback, handling rollback excepitons properly. The session to rollback. The thrown application exception. in case of a rollback error. Handle the given exception that arose during listener execution. The default implementation logs the exception at error level, not propagating it to the JMS provider - assuming that all handling of acknowledgement and/or transactions is done by this listener container. This can be overridden in subclasses. The exceptin to handle Invokes the registered exception listener, if any. The exception that arose during EMS processing. Checks the message listener, throwing an exception if it does not correspond to a supported listener type. By default, only a standard JMS MessageListener object or a Spring object will be accepted. The message listener. Gets or sets the destination to receive messages from. Will be null if the configured destination is not an actual Destination type; c.f. when the destination is a String. The destination. Gets or sets the name of the destination to receive messages from. Will be null if the configured destination is not a string type; c.f. when it is an actual Destination object. The name of the destination. Gets or sets the message selector. The message selector expression (or null if none).. Gets or sets the message listener to register. This can be either a standard EMS MessageListener object or a Spring object. The message listener. Gets or sets a value indicating whether the subscription is durable. Set whether to make the subscription durable. The durable subscription name to be used can be specified through the "DurableSubscriptionName" property. Default is "false". Set this to "true" to register a durable subscription, typically in combination with a "DurableSubscriptionName" value (unless your message listener class name is good enough as subscription name). Only makes sense when listening to a topic (pub-sub domain). true if the subscription is durable; otherwise, false. Gets or sets the name of the durable subscription to create. To be applied in case of a topic (pub-sub domain) with subscription durability activated. The durable subscription name needs to be unique within this client's client id. Default is the class name of the specified message listener. Note: Only 1 concurrent consumer (which is the default of this message listener container) is allowed for each durable subscription. The name of the durable subscription. Gets or sets the exception listener to notify in case of a EMSException thrown by the registered message listener or the invocation infrastructure. The exception listener. Sets an ErrorHandler to be invoked in case of any uncaught exceptions thrown while processing a Message. By default there will be no ErrorHandler so that error-level logging is the only result. The error handler. Gets or sets a value indicating whether to expose listener session to a registered as well as to calls. Default is "true", reusing the listener's Session. Turn this off to expose a fresh Session fetched from the same underlying Connection instead, which might be necessary on some messaging providers. Note that Sessions managed by an external transaction manager will always get exposed to calls. So in terms of EmsTemplate exposure, this setting only affects locally transacted Sessions. true if expose listener session; otherwise, false. Gets or sets a value indicating whether to accept messages while the listener container is in the process of stopping. Return whether to accept received messages while the listener container receive attempt. Switch this flag on to fully process such messages even in the stopping phase, with the drawback that even newly sent messages might still get processed (if coming in before all receive timeouts have expired). Aborting receive attempts for such incoming messages might lead to the provider's retry count decreasing for the affected messages. If you have a high number of concurrent consumers, make sure that the number of retries is higher than the number of consumers, to be on the safe side for all potential stopping scenarios. true if accept messages while in the process of stopping; otherwise, false. Internal exception class that indicates a rejected message on shutdown. Used to trigger a rollback for an external transaction manager in that case. EmsResourceHolder marker subclass that indicates local exposure, i.e. that does not indicate an externally managed transaction. Juergen Hoeller Mark Pollack (.NET) Initializes a new instance of the class. The session. Exception thrown when the maximum connection recovery time has been exceeded. Mark Pollack Initializes a new instance of the class, with the specified message The message. Initializes a new instance of the class, with the specified message and root cause exception The message. The inner exception. Message listener container that uses the plain EMS client API's MessageConsumer.Listener method to create concurrent MessageConsumers for the specified listeners. Juergen Hoeller Mark Pollack (.NET) The default recovery time interval between connection reconnection attempts The total time connection recovery will be attempted. Call base class for valdation and then check that if the subscription is durable that the number of concurrent consumers is equal to one. Creates the specified number of concurrent consumers, in the form of a JMS Session plus associated MessageConsumer Re-initializes this container's EMS message consumers, if not initialized already. Registers this listener container as EMS ExceptionListener on the shared connection. implementation, invoked by the EMS provider in case of connection failures. Re-initializes this listener container's shared connection and its sessions and consumers. The reported connection exception. Refresh the underlying Connection, not returning before an attempt has been successful. Called in case of a shared Connection as well as without shared Connection, so either needs to operate on the shared Connection or on a temporary Connection that just gets established for validation purposes. The default implementation retries until it successfully established a Connection, for as long as this message listener container is active. Applies the specified recovery interval between retries. The amount of time to sleep in between recovery attempts. Initialize the Sessions and MessageConsumers for this container. in case of setup failure. Creates a MessageConsumer for the given Session, registering a MessageListener for the specified listener The session to work on. the MessageConsumer"/> if thrown by EMS methods Close the message consumers and sessions. EMSException if destruction failed Creates a MessageConsumer for the given Session and Destination. The session to create a MessageConsumer for. The destination to create a MessageConsumer for. The new MessageConsumer Gets or sets a value indicating whether to inhibit the delivery of messages published by its own connection. Default is "false". true if should inhibit the delivery of messages published by its own connection; otherwise, false. Specify the number of concurrent consumers to create. Default is 1. Raising the number of concurrent consumers is recommendable in order to scale the consumption of messages coming in from a queue. However, note that any ordering guarantees are lost once multiple consumers are registered. In general, stick with 1 consumer for low-volume queues. Do not raise the number of concurrent consumers for a topic. This would lead to concurrent consumption of the same message, which is hardly ever desirable. The concurrent consumers. Sets the time interval between connection recovery attempts. The default is 5 seconds. The recovery interval. Sets the max recovery time to try reconnection attempts. The default is 10 minutes. The max recovery time. Always use a shared EMS connection Strategy interface that specifies a IMessageConverter between .NET objects and EMS messages. Mark Pollack Juergen Hoeller Mark Pollack (.NET) Convert a .NET object to a EMS Message using the supplied session to create the message object. the object to convert the Session to use for creating a EMS Message the EMS Message EMSException if thrown by EMS API methods MessageConversionException in case of conversion failure Convert from a EMS Message to a .NET object. the message to convert the converted .NET object MessageConversionException in case of conversion failure Provides a layer of indirection when adding the 'type' of the object as a message property. Mark Pollack Convert from a type to a string. The type of object to convert. Convert from a string to a type The type id. Gets the name of the field in the message that has type information.. The name of the type id field. Thrown by IMessageConverter implementations when the conversion of an object to/from a Message fails. Mark Pollack Creates a new instance of the IMessageConverterException class. with the specified message. A message about the exception. Creates a new instance of the IMessageConverterException class with the specified message and root cause. A message about the exception. The root exception that is being wrapped. A simple message converter that can handle TextMessages, BytesMessages, MapMessages, and ObjectMessages. Used as default by EmsTemplate, for 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).

Juergen Hoeller Mark Pollack (.NET)
Convert a .NET object to a EMS Message using the supplied session to create the message object. the object to convert the Session to use for creating a EMS Message the EMS Message EMSException if thrown by EMS API methods MessageConversionException in case of conversion failure Convert from a EMS Message to a .NET object. the message to convert the converted .NET object MessageConversionException in case of conversion failure Create a EMS TextMessage for the given String. the String to convert current EMS session the resulting message EMSException if thrown by EMS methods Create a EMS BytesMessage for the given byte array. the byyte array to convert current EMS session the resulting message EMSException if thrown by EMS methods Create a EMS MapMessage for the given Map. the Map to convert current EMS session the resulting message EMSException if thrown by EMS methods Create a EMS ObjectMessage for the given Serializable object. the Serializable object to convert current EMS session the resulting message EMSException if thrown by EMS methods Extract a String from the given TextMessage. the message to convert the resulting String EMSException if thrown by EMS methods Extract a byte array from the given BytesMessage. the message to convert the resulting byte array EMSException if thrown by EMS methods Extract a IDictionary from the given MapMessage. the message to convert the resulting Map EMSException if thrown by EMS methods Extracts the serializable object from the given object message. The message to convert. The resulting serializable object. Provides a layer of indirection when adding the 'type' of the object as a message property. Initializes a new instance of the Convert from a type to a string. The type of object to convert. Convert from a string to a type The type id. Afters the properties set. Gets or sets the id type mapping. The id type mapping. Gets the name of the field in the message that has type information.. The name of the type id field. Sets the default hashtable class. The default hashtable class. Gets or sets the default namespace. The default namespace. Gets or sets the default name of the assembly. The default name of the assembly. Convert an object via XML serialization for sending via an ITextMessage Mark Pollack Convert a .NET object to a EMS Message using the supplied session to create the message object. the object to convert the Session to use for creating a EMS Message the EMS Message EMSException if thrown by EMS API methods MessageConversionException in case of conversion failure Gets the XML string for an object The object to convert. XML string Convert from a EMS Message to a .NET object. the message to convert the converted .NET object MessageConversionException in case of conversion failure Gets the type of the target given the message. The message. Type of the target Converts a byte array to a UTF8 string. The characters. UTF8 string Converts a UTF8 string to a byte array The p XML string. Sets the type mapper. The type mapper. Gets or sets a value indicating whether encoder should emit UTF8 byte order mark. Default is false. true to specify that a Unicode byte order mark is provided; otherwise, false. Gets or sets a value indicating whether to throw an exception on invalid bytes. Default is true. true to specify that an exception be thrown when an invalid encoding is detected; otherwise, false. Simple DestinationResolver implementation resolving destination names as dynamic destinations. Juergen Hoeller Mark Pollack (.NET) Strategy interface for resolving EMS destinations. Used by EmsTemplate for resolving destination names from simple Strings to actual Destination implementation instances. The default DestinationResolver implementation used by EmsTemplate instances is the DynamicDestinationResolver class. Consider using the JndDestinationResolver for more advanced scenarios. Juergen Hoeller Mark Pollack (.NET) Resolve the given destination name, either as located resource or as dynamic destination. the current EMS Session the name of the destination true if the domain is pub-sub, false if P2P the EMS destination (either a topic or a queue) EMSException if resolution failed Resolve the given destination name, either as located resource or as dynamic destination. the current EMS Session the name of the destination true if the domain is pub-sub, false if P2P the EMS destination (either a topic or a queue) EMSException if resolution failed Resolve the given destination name to a Topic. the current EMS Session the name of the desired Topic. the EMS Topic name EMSException if resolution failed Resolve the given destination name to a Queue. the current EMS Session the name of the desired Queue. the EMS Queue name EMSException if resolution failed Generic utility methods for working with EMS. Mainly for internal use within the framework, but also useful for custom EMS access code. Close the given EMS Connection and ignore any thrown exception. This is useful for typical finally blocks in manual EMS code. the EMS Connection to close (may be null) Close the given EMS Connection and ignore any thrown exception. This is useful for typical finally blocks in manual EMS code. the EMS Connection to close (may be null) whether to call stop() before closing Close the given EMS Session and ignore any thrown exception. This is useful for typical finally blocks in manual EMS code. the EMS Session to close (may be null) Close the given EMS MessageProducer and ignore any thrown exception. This is useful for typical finally blocks in manual EMS code. the EMS MessageProducer to close (may be null) Close the given EMS MessageConsumer and ignore any thrown exception. This is useful for typical finally blocks in manual EMS code. the EMS MessageConsumer to close (may be null) Commit the Session if not within a distributed transaction. Needs investigation - no distributed tx in .NET messaging providers the EMS Session to commit EMSException if committing failed Rollback the Session if not within a distributed transaction. Needs investigation - no distributed tx in EMS the EMS Session to rollback EMSException if committing failed Closes the given queue browser and ignore any thrown exception. This is useful for typical finally blocks in manual EMS code. The queue browser to close (may be null. Converts the acknowledgement mode from an integer to an enumeration. If the integer does not match a valid enumeration, the returned enumeration is SessionMode.AutoAcknowledge The ack mode. The corresponding SessionMode enumeration