head	1.1;
access;
symbols
	REL7_3_STABLE:1.1.0.2;
locks; strict;
comment	@# @;


1.1
date	2002.08.10.21.03.36;	author jtv;	state Exp;
branches;
next	;


desc
@@


1.1
log
@Added Ray Dassen's Debian stuff, autoconf updates, and .cvsignore files;
added doxygen-generated reference documentation
@
text
@<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>pqxx::RobustTransaction class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.2.16 -->
<center>
<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="namespaces.html">Namespace List</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="namespacemembers.html">Namespace Members</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; </center>
<hr><h1>pqxx::RobustTransaction  Class Reference</h1>Slower, better fortified version of <a class="el" href="classpqxx_1_1Transaction.html">Transaction</a>. 
<a href="#_details">More...</a>
<p>
<code>#include &lt;<a class="el" href="robusttransaction_8h-source.html">robusttransaction.h</a>&gt;</code>
<p>
<p>Inheritance diagram for pqxx::RobustTransaction:
<p><center><img src="classpqxx_1_1RobustTransaction.png" usemap="#pqxx::RobustTransaction_map" border="0"></center>
<map name="pqxx::RobustTransaction_map">
<area href="classpqxx_1_1TransactionItf.html" alt="pqxx::TransactionItf" shape="rect" coords="0,0,147,24">
</map>
<a href="classpqxx_1_1RobustTransaction-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classpqxx_1_1RobustTransaction.html#a0">RobustTransaction</a> (<a class="el" href="classpqxx_1_1Connection.html">Connection</a> &amp;, PGSTD::string Name=PGSTD::string())</td></tr>
<tr><td nowrap align=right valign=top>virtual&nbsp;</td><td valign=bottom><a class="el" href="classpqxx_1_1RobustTransaction.html#a1">~RobustTransaction</a> ()</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Slower, better fortified version of <a class="el" href="classpqxx_1_1Transaction.html">Transaction</a>.
<p>
<a class="el" href="classpqxx_1_1RobustTransaction.html">RobustTransaction</a> is similar to <a class="el" href="classpqxx_1_1Transaction.html">Transaction</a>, but spends more effort (and performance!) to deal with the hopefully rare case that the connection to the backend is lost just as the current transaction is being committed. In this case, there is no way to determine whether the backend managed to commit the transaction before noticing the loss of connection.
<p>
In such cases, transaction class tries to reconnect to the database and figure out what happened. It will need to store and manage some information (pretty much a user-level transaction log) in the back-end for each and every transaction just on the off chance that this problem might occur. This service level was made optional since you may not want to pay this overhead where it is not necessary. Certainly the use of this class makes no sense for local connections, or for transactions that read the database but never modify it, or for noncritical database manipulations.
<p>
Besides being slower, you may find that <a class="el" href="classpqxx_1_1RobustTransaction.html">RobustTransaction</a> actually fails more instead of less often than a normal <a class="el" href="classpqxx_1_1Transaction.html">Transaction</a>. This is due to the added work and complexity. What <a class="el" href="classpqxx_1_1RobustTransaction.html">RobustTransaction</a> tries to achieve is to be more deterministic, not more successful per se. 
<p>
<hr><h2>Constructor &amp; Destructor Documentation</h2>
<a name="a0" doxytag="pqxx::RobustTransaction::RobustTransaction"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> pqxx::RobustTransaction::RobustTransaction </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="classpqxx_1_1Connection.html">Connection</a> &amp;&nbsp;</td>
          <td class="mdname" nowrap>&nbsp;, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>PGSTD::string&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>Name</em> = PGSTD::string()</td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [explicit]</code></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<a name="a1" doxytag="pqxx::RobustTransaction::~RobustTransaction"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> pqxx::RobustTransaction::~RobustTransaction </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap><code> [virtual]</code></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
    </td>
  </tr>
</table>
<hr>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="robusttransaction_8h-source.html">robusttransaction.h</a><li><a class="el" href="robusttransaction_8cxx.html">robusttransaction.cxx</a></ul>
<hr><address align="right"><small>Generated on Sat Aug 10 21:52:39 2002 for libpqxx by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0 
width=110 height=53></a>1.2.16 </small></address>
</body>
</html>
@
