transaction.hxx

Go to the documentation of this file.

/* Definition of the pqxx::transaction class.
 * pqxx::transaction represents a standard database transaction.
 *
 * DO NOT INCLUDE THIS FILE DIRECTLY; include pqxx/transaction instead.
 *
 * Copyright (c) 2000-2026, Jeroen T. Vermeulen.
 *
 * 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_TRANSACTION_HXX
#define PQXX_TRANSACTION_HXX
 
#if !defined(PQXX_HEADER_PRE)
#  error "Include libpqxx headers as <pqxx/header>, not <pqxx/header.hxx>."
#endif
 
#include "pqxx/dbtransaction.hxx"
 
namespace pqxx::internal
{
class PQXX_LIBEXPORT basic_transaction : public dbtransaction
{
protected:
  basic_transaction(
    connection &cx, zview begin_command, std::string_view tname,
    sl = sl::current());
  basic_transaction(
    connection &cx, zview begin_command, std::string &&tname,
    sl = sl::current());
  basic_transaction(connection &cx, zview begin_command, sl = sl::current());
 
private:
  void do_commit(sl) override;
 
public:
  basic_transaction() = delete;
  basic_transaction(basic_transaction const &) = delete;
  basic_transaction(basic_transaction &&) = delete;
 
  // NOLINTNEXTLINE(cppcoreguidelines-virtual-class-destructor)
  ~basic_transaction() noexcept override = 0;
 
  basic_transaction &operator=(basic_transaction const &) = delete;
  basic_transaction &operator=(basic_transaction &&) = delete;
};
} // namespace pqxx::internal
 
 
namespace pqxx
{
 
template<
  isolation_level ISOLATION = isolation_level::read_committed,
  write_policy READWRITE = write_policy::read_write>
class transaction final : public internal::basic_transaction
{
public:
 
  transaction(connection &cx, std::string_view tname, sl loc = sl::current()) :
          internal::basic_transaction{
            cx, internal::begin_cmd<ISOLATION, READWRITE>, tname, loc}
  {}
 
 
  explicit transaction(connection &cx, sl loc = sl::current()) :
          internal::basic_transaction{
            cx, internal::begin_cmd<ISOLATION, READWRITE>, loc}
  {}
 
  transaction(transaction const &) = delete;
  transaction(transaction &&) = delete;
  transaction &operator=(transaction const &) = delete;
  transaction &operator=(transaction &&) = delete;
 
  ~transaction() noexcept override { close(sl::current()); }
};
 
 
 
using work =
  transaction<isolation_level::read_committed, write_policy::read_write>;
 
 
 
using read_transaction =
  transaction<isolation_level::read_committed, write_policy::read_only>;
 
} // namespace pqxx
#endif