include/anna/dbms.oracle/Statement.hpp

   1 // ANNA - Anna is Not Nothingness Anymore                                                         //
   2 //                                                                                                //
   3 // (c) Copyright 2005-2015 Eduardo Ramos Testillano & Francisco Ruiz Rayo                         //
   4 //                                                                                                //
   5 // See project site at http://redmine.teslayout.com/projects/anna-suite                           //
   6 // See accompanying file LICENSE or copy at http://www.teslayout.com/projects/public/anna.LICENSE //
   7
   8
   9 #ifndef anna_dbms_oracle_Statement_hpp
  10 #define anna_dbms_oracle_Statement_hpp
  11
  12 #include <anna/dbms/Statement.hpp>
  13
  14 struct OCIStmt;
  15 struct OCIError;
  16
  17 namespace anna {
  18
  19 namespace dbms {
  20
  21 class Connection;
  22
  23 namespace oracle {
  24
  25 /**
  26    Clase que facilita la ejecucion de sentencias SQL a traves del RDBMS Oracle (tm).
  27
  28    Esta clase no puede usarse directamente, ya que la capa ANNA.dbms obliga a que todas las peticiones
  29    se hagan atraves de una instancia anna::dbms::Statement.
  30
  31    Para obtener la instancia de un comando para una determinada base de datos habra que instanciar
  32    dicha base de datos e invocar al metodo createStatement. Independientemente del tipo de comando
  33    particular que la base de datos retorne, debemos asignarlo a un puntero de tipo anna::dbms::Statement.
  34  */
  35 class Statement : public dbms::Statement {
  36 public:
  37   /**
  38      Destructor.
  39   */
  40   virtual ~Statement();
  41
  42   /**
  43      Operador de conversion.
  44      \return El puntero OCI de esta sentencia.
  45   */
  46   operator OCIStmt*() throw() { return a_ociStmt; }
  47
  48 private:
  49   OCIStmt* a_ociStmt;
  50   OCIError* a_ociError;
  51   bool a_firstFetch;
  52
  53   Statement(Database& database, const char* name, const char* expression, const bool isCritical) :
  54     dbms::Statement(database, name, expression, isCritical),
  55     a_ociStmt(NULL),
  56     a_ociError(NULL) {}
  57
  58   Statement(Database& database, const char* name, const std::string& expression, const bool isCritical) :
  59     dbms::Statement(database, name, expression, isCritical),
  60     a_ociStmt(NULL),
  61     a_ociError(NULL) {}
  62
  63   void prepare(dbms::Connection* connection) throw(RuntimeException, DatabaseException);
  64   dbms::ResultCode execute(dbms::Connection* connection) throw(RuntimeException, DatabaseException);
  65   bool fetch() throw(RuntimeException, DatabaseException);
  66
  67   friend class Database;
  68 };
  69
  70 }
  71 }
  72 }
  73
  74 #endif
  75