com.azure.messaging.servicebus

Class ServiceBusTransactionContext

java.lang.Object

com.azure.messaging.servicebus.ServiceBusTransactionContext

public final class ServiceBusTransactionContext
extends Object

Represents transaction in service. This object just contains transaction id. Transaction management operations like create transaction, rollback, and commit operation need to be done using the sender or receiver clients.

A transaction times out after 2 minutes. The transaction timer starts when the first operation in the transaction starts.

Creating and using a transaction

 // This mono creates a transaction and caches the output value, so we can associate operations with the
 // transaction. It does not cache the value if it is an error or completes with no items, effectively retrying
 // the operation.
 Mono<ServiceBusTransactionContext> transactionContext = receiver.createTransaction()
     .cache(value -> Duration.ofMillis(Long.MAX_VALUE),
         error -> Duration.ZERO,
         () -> Duration.ZERO);
 
 transactionContext.flatMap(transaction -> {
     // Process messages and associate operations with the transaction.
     Mono<Void> operations = Mono.when(
         receiver.receiveDeferredMessage(sequenceNumber).flatMap(message ->
             receiver.complete(message, new CompleteOptions().setTransactionContext(transaction))),
         receiver.abandon(receivedMessage, new AbandonOptions().setTransactionContext(transaction)));
 
     // Finally, either commit or rollback the transaction once all the operations are associated with it.
     return operations.flatMap(transactionOperations -> receiver.commitTransaction(transaction));
 });
 

See Also:

ServiceBusReceiverClient.createTransaction(), ServiceBusReceiverAsyncClient.createTransaction(), ServiceBusSenderClient.createTransaction(), ServiceBusSenderAsyncClient.createTransaction(), Transaction Overview

Method Summary

Modifier and Type	Method and Description
ByteBuffer	getTransactionId() Gets the transaction id.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getTransactionId

public ByteBuffer getTransactionId()

Gets the transaction id.

Returns:

transaction ID