Provides a context to do transactional operations; so beginning/committing transactions, but also retrieving transactional data-structures like the TransactionalMap. More...

#include <transaction_context.h>

Public Member Functions
	transaction_context (spi::impl::ClientTransactionManagerServiceImpl &transaction_manager, const transaction_options &)
	Constructor to be used internally. More...

boost::uuids::uuid	get_txn_id () const

boost::future< void >	begin_transaction ()
	Begins a transaction. More...

boost::future< void >	commit_transaction ()
	Commits a transaction. More...

boost::future< void >	rollback_transaction ()
	Begins a transaction. More...

std::shared_ptr< transactional_map >	get_map (const std::string &name)
	Returns the transactional distributed map instance with the specified name. More...

std::shared_ptr< transactional_queue >	get_queue (const std::string &name)
	Returns the transactional queue instance with the specified name. More...

std::shared_ptr< transactional_multi_map >	get_multi_map (const std::string &name)
	Returns the transactional multimap instance with the specified name. More...

std::shared_ptr< transactional_list >	get_list (const std::string &name)
	Returns the transactional list instance with the specified name. More...

std::shared_ptr< transactional_set >	get_set (const std::string &name)
	Returns the transactional set instance with the specified name. More...

template<typename T >
std::shared_ptr< T >	get_transactional_object (const std::string &service_name, const std::string &name)
	get any transactional object with template T. More...

Detailed Description

Provides a context to do transactional operations; so beginning/committing transactions, but also retrieving transactional data-structures like the TransactionalMap.

See also: hazelcast_client::newTransactionContext

Definition at line 60 of file transaction_context.h.

Constructor & Destructor Documentation

◆ transaction_context()

hazelcast::client::transaction_context::transaction_context	(	spi::impl::ClientTransactionManagerServiceImpl &	transaction_manager,
		const transaction_options &	txn_options
	)

Constructor to be used internally.

Not public API.

Definition at line 561 of file transactions.cpp.

                                                                                          : options_(txn_options),
                                                                                            txn_connection_(
                                                                                                transaction_manager.connect()),
                                                                                            transaction_(options_,
                                                                                                    transaction_manager.get_client(),
                                                                                                    txn_connection_) {
         }

Member Function Documentation

◆ begin_transaction()

boost::future< void > hazelcast::client::transaction_context::begin_transaction ( )

Begins a transaction.

Exceptions

illegal_state if a transaction already is active.

Definition at line 574 of file transactions.cpp.

                                                                  {
             return transaction_.begin();
         }

◆ commit_transaction()

boost::future< void > hazelcast::client::transaction_context::commit_transaction ( )

Commits a transaction.

Exceptions

transaction if no transaction is active or the transaction could not be committed.

Definition at line 578 of file transactions.cpp.

                                                                   {
             return transaction_.commit();
         }

◆ get_list()

std::shared_ptr<transactional_list> hazelcast::client::transaction_context::get_list ( const std::string & name )

inline

Returns the transactional list instance with the specified name.

Parameters

name	name of the list

Returns: transactional list instance with the specified name

Definition at line 135 of file transaction_context.h.

                                                                               {
                 return get_transactional_object<transactional_list>(ilist::SERVICE_NAME, name);
             }

◆ get_map()

std::shared_ptr<transactional_map> hazelcast::client::transaction_context::get_map ( const std::string & name )

inline

Returns the transactional distributed map instance with the specified name.

Parameters

name	name of the distributed map

Returns: transactional distributed map instance with the specified name

Definition at line 102 of file transaction_context.h.

                                                                             {
                 return get_transactional_object<transactional_map>(imap::SERVICE_NAME, name);
             }

◆ get_multi_map()

std::shared_ptr<transactional_multi_map> hazelcast::client::transaction_context::get_multi_map ( const std::string & name )

inline

Returns the transactional multimap instance with the specified name.

Parameters

name	name of the multimap

Returns: transactional multimap instance with the specified name

Definition at line 124 of file transaction_context.h.

                                                                                         {
                 return get_transactional_object<transactional_multi_map>(multi_map::SERVICE_NAME, name);
             }

◆ get_queue()

std::shared_ptr<transactional_queue> hazelcast::client::transaction_context::get_queue ( const std::string & name )

inline

Returns the transactional queue instance with the specified name.

Parameters

name	name of the queue

Returns: transactional queue instance with the specified name

Definition at line 113 of file transaction_context.h.

                                                                                 {
                 return get_transactional_object<transactional_queue>(iqueue::SERVICE_NAME, name);
             }

◆ get_set()

std::shared_ptr<transactional_set> hazelcast::client::transaction_context::get_set ( const std::string & name )

inline

Returns the transactional set instance with the specified name.

Parameters

name	name of the set

Returns: transactional set instance with the specified name

Definition at line 146 of file transaction_context.h.

                                                                             {
                 return get_transactional_object<transactional_set>(iset::SERVICE_NAME, name);
             }

◆ get_transactional_object()

template<typename T >

std::shared_ptr<T> hazelcast::client::transaction_context::get_transactional_object	(	const std::string &	service_name,
		const std::string &	name
	)

inline

get any transactional object with template T.

Mostly to be used by spi implementers of Hazelcast.

Returns: transactionalObject.

Definition at line 158 of file transaction_context.h.

                                                                                                             {
                 if (transaction_.get_state() != txn::TxnState::ACTIVE) {
                     std::string message = "No transaction is found while accessing ";
                     message += "transactional object -> [" + name + "]!";
                     BOOST_THROW_EXCEPTION(
                             exception::illegal_state("TransactionContext::getMap(const std::string& name)",
                                                              message));
                 }
                 auto key = std::make_pair(service_name, name);
                 std::shared_ptr<T> obj = std::static_pointer_cast<T>(txn_object_map_.get(key));
                 if (!obj) {
                     obj = std::shared_ptr<T>(new T(name, transaction_));
                     txn_object_map_.put(key, obj);
                 }
  
                 return obj;
             }

◆ get_txn_id()

boost::uuids::uuid hazelcast::client::transaction_context::get_txn_id ( ) const

Returns: txn id.

Definition at line 570 of file transactions.cpp.

                                                               {
             return transaction_.get_txn_id();
         }

◆ rollback_transaction()

boost::future< void > hazelcast::client::transaction_context::rollback_transaction ( )

Begins a transaction.

Exceptions

illegal_state if a transaction already is active.

Definition at line 582 of file transactions.cpp.

                                                                     {
             return transaction_.rollback();
         }

The documentation for this class was generated from the following files:

hazelcast/include/hazelcast/client/transaction_context.h
hazelcast/src/hazelcast/client/transactions.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ transaction_context()

Member Function Documentation

◆ begin_transaction()

◆ commit_transaction()

◆ get_list()

◆ get_map()

◆ get_multi_map()

◆ get_queue()

◆ get_set()

◆ get_transactional_object()

◆ get_txn_id()

◆ rollback_transaction()