connection.hxx

Go to the documentation of this file.

/*-------------------------------------------------------------------------
 *
 *   FILE
 *      pqxx/connection.hxx
 *
 *   DESCRIPTION
 *      definition of the pqxx::connection and pqxx::lazyconnection classes.
 *   Different ways of setting up a backend connection.  
 *   DO NOT INCLUDE THIS FILE DIRECTLY; include pqxx/connection instead.
 *
 * Copyright (c) 2001-2004, 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.
 *
 *-------------------------------------------------------------------------
 */
#include "pqxx/connection_base"


/* Methods tested in eg. self-test program test001 are marked with "//[t1]"
 */

namespace pqxx
{


class PQXX_LIBEXPORT connection : public connection_base
{
public:

  connection();                                                         //[t1]


  explicit connection(const PGSTD::string &ConnInfo);                   //[t2]


  explicit connection(const char ConnInfo[]);                           //[t3]

  virtual ~connection() throw ();

private:
  virtual void startconnect() { do_startconnect(); }
  virtual void completeconnect() {}

  void do_startconnect() 
        { if (!get_conn()) set_conn(PQXXPQ::PQconnectdb(options())); }
};



class PQXX_LIBEXPORT lazyconnection : public connection_base
{
public:
  lazyconnection() : connection_base(0) {}                              //[t23]


  explicit lazyconnection(const PGSTD::string &ConnInfo) :              //[t21]
        connection_base(ConnInfo) {}


  explicit lazyconnection(const char ConnInfo[]) :                      //[t22]
        connection_base(ConnInfo) {}

  virtual ~lazyconnection() throw ();

private:
  virtual void startconnect() {}
  virtual void completeconnect() 
        { if (!get_conn()) set_conn(PQXXPQ::PQconnectdb(options())); }
};



class PQXX_LIBEXPORT asyncconnection : public connection_base
{
public:
  asyncconnection();                                                    //[t63]


  explicit asyncconnection(const PGSTD::string &ConnInfo);              //[t65]


  explicit asyncconnection(const char ConnInfo[]);                      //[t64]

  virtual ~asyncconnection() throw ();

private:
  virtual void startconnect() { do_startconnect(); }
  virtual void completeconnect();
  virtual void dropconnect() throw () { do_dropconnect(); }

  void do_startconnect();
  void do_dropconnect() throw () { m_connecting = false; }

  bool m_connecting;
};



class PQXX_LIBEXPORT nullconnection : public connection_base
{
public:
  nullconnection() : connection_base("") {}                             //[t0]
  explicit nullconnection(const PGSTD::string &c) :                     //[t0]
        connection_base(c) {}
  explicit nullconnection(const char c[]) :                             //[t0]
        connection_base(c) {}

  virtual ~nullconnection() throw ();

private:
  virtual void startconnect() {}
  virtual void completeconnect() {}
};

}

/* On Windows, any user-allocated notice processors, triggers etc. must be
 * deallocated in the user context.  Therefore we want these destructors to be
 * inlined.
 * On SUN's CC 5.1 compiler, on the other hand, there will be problems if we
 * don't have out-of-line virtual destructors in the leaf classes, so we must
 * not inline them.
 */
#ifdef _WIN32
inline pqxx::connection::~connection() throw () { close(); }
inline pqxx::lazyconnection::~lazyconnection() throw () { close(); }
inline pqxx::asyncconnection::~asyncconnection() throw () {do_dropconnect();close();}
#endif

---