Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

pqxx::Transaction Class Reference

Back-end transaction. More...

#include <transaction.h>

Inheritance diagram for pqxx::Transaction:

pqxx::TransactionItf List of all members.

Public Member Functions

 Transaction (Connection &, const PGSTD::string &Name=PGSTD::string())
virtual ~Transaction ()

Detailed Description

Back-end transaction.

Use a Transaction object to enclose operations on a database in a single "unit of work." This ensures that the whole series of operations either succeeds as a whole or fails completely. In no case will it leave half finished work behind in the database.

Queries can currently only be issued through a Transaction.

Once processing on a transaction has succeeded and any changes should be allowed to become permanent in the database, call Commit(). If something has gone wrong and the changes should be forgotten, call Abort() instead. If you do neither, an implicit Abort() is executed at destruction time.

It is an error to abort a Transaction that has already been committed, or to commit a transaction that has already been aborted. Aborting an already aborted transaction or committing an already committed one has been allowed to make errors easier to deal with. Repeated aborts or commits have no effect after the first one.

Database transactions are not suitable for guarding long-running processes. If your transaction code becomes too long or too complex, please consider ways to break it up into smaller ones. There's no easy, general way to do this since application-specific considerations become important at this point.


Constructor & Destructor Documentation

pqxx::Transaction::Transaction Connection  ,
const PGSTD::string &    Name = PGSTD::string()
[explicit]
 

Create a transaction. The optional name, if given, must begin with a letter and may contain letters and digits only.

pqxx::Transaction::~Transaction   [virtual]
 


The documentation for this class was generated from the following files:
Generated on Fri Feb 28 19:23:33 2003 for libpqxx by doxygen1.3-rc3