CacheTransactionManager encapsulates the transactions for a cache More...

#include <CacheTransactionManager.hpp>

Public Member Functions
void	Begin ()
	Creates a new transaction and associates it with the current thread. More...

void	Commit ()
	Commit the transaction associated with the current thread. More...

bool	Exists ()
	Reports the existence of a Transaction for this thread More...

bool	Exists (Apache::Geode::Client::TransactionId^ transactionId)
	Reports the existence of a transaction for the given transactionId. More...

bool	IsSuspended (Apache::Geode::Client::TransactionId^ transactionId)
	This method can be used to determine if a transaction with the given transaction identifier is currently suspended locally. More...

void	Prepare ()
	Prepare the first message of two-phase-commit transaction associated with the current thread. More...

void	Resume (Apache::Geode::Client::TransactionId^ transactionId)
	On the current thread, resumes a transaction that was previously suspended using suspend More...

void	Rollback ()
	Roll back the transaction associated with the current thread. More...

Apache::Geode::Client::TransactionId ^	Suspend ()
	Suspends the transaction on the current thread. More...

bool	TryResume (Apache::Geode::Client::TransactionId^ transactionId)
	On the current thread, resumes a transaction that was previously suspended using suspend. More...

bool	TryResume (Apache::Geode::Client::TransactionId^ transactionId, TimeSpan waitTime)
	On the current thread, resumes a transaction that was previously suspended using suspend, or waits for the specified timeout interval if the transaction has not been suspended. More...

Properties
Apache::Geode::Client::TransactionId^	TransactionId `[get]`
	Returns the transaction identifier for the current thread More...

Detailed Description

CacheTransactionManager encapsulates the transactions for a cache

Member Function Documentation

◆ Begin()

void Apache::Geode::Client::CacheTransactionManager::Begin ( )

Creates a new transaction and associates it with the current thread.

Exceptions

IllegalStateException Throws exception if the thread is already associated with a transaction

◆ Commit()

void Apache::Geode::Client::CacheTransactionManager::Commit ( )

Commit the transaction associated with the current thread.

If the commit operation fails due to a conflict it will destroy the transaction state and throw a CommitConflictException. If the commit operation succeeds,it returns after the transaction state has been merged with committed state. When this method completes, the thread is no longer associated with a transaction.

Exceptions

IllegalStateException	if the thread is not associated with a transaction
CommitConflictException	if the commit operation fails due to a write conflict.

◆ Exists() [1/2]

bool Apache::Geode::Client::CacheTransactionManager::Exists ( )

Reports the existence of a Transaction for this thread

Returns: true if a transaction exists, false otherwise

◆ Exists() [2/2]

bool Apache::Geode::Client::CacheTransactionManager::Exists ( Apache::Geode::Client::TransactionId^ transactionId )

Reports the existence of a transaction for the given transactionId.

This method can be used to determine if a transaction with the given transaction identifier is currently in progress locally.

Since 3.6.2

Parameters

transactionId the given transaction identifier

Returns: true if the transaction is in progress, false otherwise.

isSuspended

◆ IsSuspended()

bool Apache::Geode::Client::CacheTransactionManager::IsSuspended ( Apache::Geode::Client::TransactionId^ transactionId )

This method can be used to determine if a transaction with the given transaction identifier is currently suspended locally.

This method does not check other members for transaction status.

Since 3.6.2

Parameters

transactionId

Returns: true if the transaction is in suspended state, false otherwise

TransactionId

◆ Prepare()

void Apache::Geode::Client::CacheTransactionManager::Prepare ( )

Prepare the first message of two-phase-commit transaction associated with the current thread.

Exceptions

IllegalStateException	if the thread is not associated with a transaction
CommitConflictException	if the commit operation fails due to a write conflict.

◆ Resume()

void Apache::Geode::Client::CacheTransactionManager::Resume ( Apache::Geode::Client::TransactionId^ transactionId )

On the current thread, resumes a transaction that was previously suspended using suspend

Since 3.6.2

Parameters

transactionId the transaction to resume

Exceptions

IllegalStateException if the thread is associated with a transaction or if would return false for the given transactionId

TransactionId

◆ Rollback()

void Apache::Geode::Client::CacheTransactionManager::Rollback ( )

Roll back the transaction associated with the current thread.

When this method completes, the thread is no longer associated with a transaction and the transaction context is destroyed.

Exceptions

IllegalStateException if the thread is not associated with a transaction

◆ Suspend()

Apache::Geode::Client::TransactionId ^ Apache::Geode::Client::CacheTransactionManager::Suspend ( )

Suspends the transaction on the current thread.

All subsequent operations performed by this thread will be non-transactional. The suspended transaction can be resumed by calling TransactionId

Since 3.6.2

Returns: the transaction identifier of the suspended transaction or null if the thread was not associated with a transaction

◆ TryResume() [1/2]

bool Apache::Geode::Client::CacheTransactionManager::TryResume ( Apache::Geode::Client::TransactionId^ transactionId )

On the current thread, resumes a transaction that was previously suspended using suspend.

This method is equivalent to if (isSuspended(txId)) { resume(txId); } except that this action is performed atomically

Since 3.6.2

Parameters

transactionId the transaction to resume

Returns: true if the transaction was resumed, false otherwise

◆ TryResume() [2/2]

bool Apache::Geode::Client::CacheTransactionManager::TryResume	(	Apache::Geode::Client::TransactionId^	transactionId,
		TimeSpan	waitTime
	)

On the current thread, resumes a transaction that was previously suspended using suspend, or waits for the specified timeout interval if the transaction has not been suspended.

This method will return if:

Another thread suspends the transaction

Another thread calls commit/rollback on the transaction

This thread has waited for the specified timeout

This method returns immediately if TransactionId returns false.

Since 3.6.2

Parameters

transactionId	the transaction to resume
waitTime	the maximum time to wait

Returns: true if the transaction was resumed, false otherwise

Property Documentation

◆ TransactionId

Apache:: Geode:: Client:: TransactionId^ Apache::Geode::Client::CacheTransactionManager::TransactionId

get

Returns the transaction identifier for the current thread

Since 3.6.2

Returns: the transaction identifier or null if no transaction exists

Public Member Functions

Properties

Detailed Description

Member Function Documentation

◆ Begin()

◆ Commit()

◆ Exists() [1/2]

◆ Exists() [2/2]

◆ IsSuspended()

◆ Prepare()

◆ Resume()

◆ Rollback()

◆ Suspend()

◆ TryResume() [1/2]

◆ TryResume() [2/2]

Property Documentation

◆ TransactionId