---

db.DbConnection.h

/*----------------------------------------------------------------------------
  SWORD 2000 - Software With Objects for Rapid Development
  Copyright (C) 2003 Eric NICOLAS
  ----------------------------------------------------------------------------
  SWORD is free software; you can redistribute it and/or modify
  it under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  SWORD is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with SWORD; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  --------------------------------------------------------------------------*/
#ifndef _SWORD_DB_DBCONNECTION_
#define _SWORD_DB_DBCONNECTION_

#include "sword/base.SmartPtr.h"

namespace sword {

  class DbConnection;
  class DbQuery;

  typedef SmartPtr<DbConnection> PDbConnection;
  typedef SmartPtr<DbQuery>      PDbQuery;

  class SWORDDECL DbException : public Exception {};

  // Abstract DbConnection class
  class SWORDDECL DbConnection {
  public:
    virtual ~DbConnection() {}

    // actual connection factory
    static PDbConnection factory(const std::string &driver, const std::string& name);

    // connects
    virtual void open(const std::string& parameters) = 0;
    virtual void close() = 0;

    // query creation
    virtual PDbQuery query() = 0;

    // transactions
    virtual void begin()    = 0;
    virtual void commit()   = 0;
    virtual void rollback() = 0;

    //
    std::string name() const { return name_; }

  protected:
    // Private constructor : must use the factory
    DbConnection(const std::string& name) : name_(name) {}
    std::string name_;
  };

} // namespace sword

#endif // _SWORD_DB_DBCONNECTION_

---