DistributedTxMessageListenerContainer Class
Spring.NET 1.3.0 RC1 for .NET 2.0 API Reference

DistributedTxMessageListenerContainer Class

A MessageListenerContainer that uses distributed (DTC) based transactions. Exceptions are handled by instances of IDistributedTransactionExceptionHandler.

For a list of all members of this type, see DistributedTxMessageListenerContainer Members .


[Visual Basic]
Public Class DistributedTxMessageListenerContainer
    Inherits AbstractTransactionalMessageListenerContainer
public class DistributedTxMessageListenerContainer : AbstractTransactionalMessageListenerContainer

Thread Safety

Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.


Starts a DTC based transaction before receiving the message. The transaction is automaticaly promoted to 2PC to avoid the default behaivor of transactional promotion. Database and messaging operations will commit or rollback together.

If you only want local message based transactions use the TransactionalMessageListenerContainer. With some simple programming you may also achieve 'exactly once' processing using the TransactionalMessageListenerContainer.

Poison messages can be detected and sent to another queue using Spring's SendToQueueDistributedTransactionExceptionHandler.


Namespace: Spring.Messaging.Listener

Assembly: Spring.Messaging (in Spring.Messaging.dll)

See Also

DistributedTxMessageListenerContainer Members | Spring.Messaging.Listener Namespace