GdaTransaction

Name

GdaTransaction -- 

Synopsis



struct      GdaTransactionPrivate;
GdaTransaction* gda_transaction_new         (const gchar *name);
enum        GdaTransactionIsolation;
GdaTransactionIsolation gda_transaction_get_isolation_level
                                            (GdaTransaction *xaction);
void        gda_transaction_set_isolation_level
                                            (GdaTransaction *xaction,
                                             GdaTransactionIsolation level);
const gchar* gda_transaction_get_name       (GdaTransaction *xaction);
void        gda_transaction_set_name        (GdaTransaction *xaction,
                                             const gchar *name);

Description

Details

struct GdaTransactionPrivate

struct GdaTransactionPrivate;


gda_transaction_new ()

GdaTransaction* gda_transaction_new         (const gchar *name);

Create a new GdaTransaction object, which allows a fine-tune and full control of transactions to be used with providers.

name :

name for the transaction.

Returns :

the newly created object.


enum GdaTransactionIsolation

typedef enum {
	GDA_TRANSACTION_ISOLATION_UNKNOWN,
	GDA_TRANSACTION_ISOLATION_READ_COMMITTED,
	GDA_TRANSACTION_ISOLATION_READ_UNCOMMITTED,
	GDA_TRANSACTION_ISOLATION_REPEATABLE_READ,
	GDA_TRANSACTION_ISOLATION_SERIALIZABLE
} GdaTransactionIsolation;


gda_transaction_get_isolation_level ()

GdaTransactionIsolation gda_transaction_get_isolation_level
                                            (GdaTransaction *xaction);

Get the isolation level for the given transaction. This specifies the locking behavior for the database connection during the given transaction.

xaction :

a GdaTransaction object.

Returns :

the isolation level.


gda_transaction_set_isolation_level ()

void        gda_transaction_set_isolation_level
                                            (GdaTransaction *xaction,
                                             GdaTransactionIsolation level);

Set the isolation level for the given transaction.

xaction :

a GdaTransaction object.

level :

the isolation level.


gda_transaction_get_name ()

const gchar* gda_transaction_get_name       (GdaTransaction *xaction);

Retrieve the name of the given transaction, as specified by the client application (via a non-NULL parameter in the call to gda_transaction_new, or by calling gda_transaction_set_name). Note that some providers may set, when you call gda_connection_begin_transaction, the name of the transaction if it's not been specified by the client application, so this function may return, for some providers, values that you don't expect.

xaction :

a GdaTransaction object.

Returns :

the name of the transaction.


gda_transaction_set_name ()

void        gda_transaction_set_name        (GdaTransaction *xaction,
                                             const gchar *name);

Set the name of the given transaction. This is very useful when using providers that support named transactions.

xaction :

a GdaTransaction object.

name :

new name for the transaction.