/usr/include/pqxx/dbtransaction.hxx is in libpqxx-dev 4.0.1+dfsg-3ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 | /*-------------------------------------------------------------------------
*
* FILE
* pqxx/dbtransaction.hxx
*
* DESCRIPTION
* definition of the pqxx::dbtransaction abstract base class.
* pqxx::dbransaction defines a real transaction on the database
* DO NOT INCLUDE THIS FILE DIRECTLY; include pqxx/dbtransaction instead.
*
* Copyright (c) 2004-2009, Jeroen T. Vermeulen <jtv@xs4all.nl>
*
* See COPYING for copyright license. If you did not receive a file called
* COPYING with this source code, please notify the distributor of this mistake,
* or contact the author.
*
*-------------------------------------------------------------------------
*/
#ifndef PQXX_H_DBTRANSACTION
#define PQXX_H_DBTRANSACTION
#include "pqxx/compiler-public.hxx"
#include "pqxx/compiler-internal-pre.hxx"
#include "pqxx/transaction_base"
namespace pqxx
{
enum readwrite_policy
{
read_only,
read_write
};
/// Abstract base class responsible for bracketing a backend transaction
/**
* @addtogroup transaction Transaction classes
*
* Use a dbtransaction-derived object such as "work" (transaction<>) 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.
*
* 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.
*
* The actual operations for beginning and committing/aborting the backend
* transaction are implemented by a derived class. The implementing concrete
* class must also call Begin() and End() from its constructors and destructors,
* respectively, and implement do_exec().
*
* @warning Read-only transactions require backend version 8.0 or better. On
* older backends, these transactions will be able to modify the database.
* Even if you have a newer server version, it is not wise to rely on read-only
* transactions alone to enforce a security model.
*/
class PQXX_LIBEXPORT PQXX_NOVTABLE dbtransaction : public transaction_base
{
public:
virtual ~dbtransaction();
protected:
dbtransaction(
connection_base &,
const PGSTD::string &IsolationString,
readwrite_policy rw=read_write);
explicit dbtransaction(
connection_base &,
bool direct=true,
readwrite_policy rw=read_write);
/// Start a transaction on the backend and set desired isolation level
void start_backend_transaction();
/// Sensible default implemented here: begin backend transaction
virtual void do_begin(); //[t1]
/// Sensible default implemented here: perform query
virtual result do_exec(const char Query[]);
/// To be implemented by derived class: commit backend transaction
virtual void do_commit() =0;
/// Sensible default implemented here: abort backend transaction
/** Default implementation does two things:
* <ol>
* <li>Clears the "connection reactivation avoidance counter"</li>
* <li>Executes a ROLLBACK statement</li>
* </ol>
*/
virtual void do_abort(); //[t13]
static PGSTD::string fullname(const PGSTD::string &ttype,
const PGSTD::string &isolation);
private:
/// Precomputed SQL command to run at start of this transaction
PGSTD::string m_StartCmd;
};
} // namespace pqxx
#include "pqxx/compiler-internal-post.hxx"
#endif
|