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 .

System.Object
   AbstractListenerContainer
      AbstractMessageListenerContainer
         AbstractPeekingMessageListenerContainer
            AbstractTransactionalMessageListenerContainer
               DistributedTxMessageListenerContainer

[Visual Basic]
Public Class DistributedTxMessageListenerContainer
    Inherits AbstractTransactionalMessageListenerContainer
[C#]
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.

Remarks

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.

Requirements

Namespace: Spring.Messaging.Listener

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

See Also

DistributedTxMessageListenerContainer Members | Spring.Messaging.Listener Namespace