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-2025, 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_H_TRANSACTION
#define PQXX_H_TRANSACTION

#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);
  basic_transaction(connection &cx, zview begin_command, std::string &&tname);
  basic_transaction(connection &cx, zview begin_command);

  virtual ~basic_transaction() noexcept override = 0;

private:
  virtual void do_commit() override;
};
} // 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) :
          internal::basic_transaction{
            cx, internal::begin_cmd<ISOLATION, READWRITE>, tname}
  {}


  explicit transaction(connection &cx) :
          internal::basic_transaction{
            cx, internal::begin_cmd<ISOLATION, READWRITE>}
  {}

  virtual ~transaction() noexcept override { close(); }
};



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