storage/mozStorageStatement.h

   1 /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
   2  * vim: sw=2 ts=2 et lcs=trail\:.,tab\:>~ :
   3  * This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef mozStorageStatement_h
   8 #define mozStorageStatement_h
   9
  10 #include "nsString.h"
  11
  12 #include "nsTArray.h"
  13
  14 #include "mozStorageBindingParamsArray.h"
  15 #include "mozStorageStatementData.h"
  16 #include "mozIStorageStatement.h"
  17 #include "mozIStorageValueArray.h"
  18 #include "StorageBaseStatementInternal.h"
  19 #include "mozilla/Attributes.h"
  20
  21 struct sqlite3_stmt;
  22
  23 namespace mozilla {
  24 namespace storage {
  25 class StatementJSHelper;
  26 class Connection;
  27 class StatementParamsHolder;
  28 class StatementRowHolder;
  29
  30 class Statement final : public mozIStorageStatement,
  31                         public mozIStorageValueArray,
  32                         public StorageBaseStatementInternal {
  33  public:
  34   NS_DECL_THREADSAFE_ISUPPORTS
  35   NS_DECL_MOZISTORAGESTATEMENT
  36   NS_DECL_MOZISTORAGEBASESTATEMENT
  37   NS_DECL_MOZISTORAGEBINDINGPARAMS
  38   // NS_DECL_MOZISTORAGEVALUEARRAY (methods in mozIStorageStatement)
  39   NS_DECL_STORAGEBASESTATEMENTINTERNAL
  40
  41   Statement();
  42
  43   /**
  44    * Initializes the object on aDBConnection by preparing the SQL statement
  45    * given by aSQLStatement.
  46    *
  47    * @param aDBConnection
  48    *        The Connection object this statement is associated with.
  49    * @param aNativeConnection
  50    *        The native Sqlite connection this statement is associated with.
  51    * @param aSQLStatement
  52    *        The SQL statement to prepare that this object will represent.
  53    */
  54   nsresult initialize(Connection* aDBConnection, sqlite3* aNativeConnection,
  55                       const nsACString& aSQLStatement);
  56
  57   /**
  58    * Obtains the native statement pointer.
  59    */
  60   inline sqlite3_stmt* nativeStatement() { return mDBStatement; }
  61
  62   /**
  63    * Obtains and transfers ownership of the array of parameters that are bound
  64    * to this statment.  This can be null.
  65    */
  66   inline already_AddRefed<BindingParamsArray> bindingParamsArray() {
  67     return mParamsArray.forget();
  68   }
  69
  70  private:
  71   ~Statement();
  72
  73   sqlite3_stmt* mDBStatement;
  74   uint32_t mParamCount;
  75   uint32_t mResultColumnCount;
  76   nsTArray<nsCString> mColumnNames;
  77   bool mExecuting;
  78
  79   /**
  80    * @return a pointer to the BindingParams object to use with our Bind*
  81    *         method.
  82    */
  83   mozIStorageBindingParams* getParams();
  84
  85   /**
  86    * Holds the array of parameters to bind to this statement when we execute
  87    * it asynchronously.
  88    */
  89   RefPtr<BindingParamsArray> mParamsArray;
  90
  91   /**
  92    * The following two members are only used with the JS helper.  They cache
  93    * the row and params objects.
  94    */
  95   nsMainThreadPtrHandle<StatementParamsHolder> mStatementParamsHolder;
  96   nsMainThreadPtrHandle<StatementRowHolder> mStatementRowHolder;
  97
  98   /**
  99    * Internal version of finalize that allows us to tell it if it is being
 100    * called from the destructor so it can know not to dispatch events that
 101    * require a reference to us.
 102    *
 103    * @param aDestructing
 104    *        Is the destructor calling?
 105    */
 106   nsresult internalFinalize(bool aDestructing);
 107
 108   friend class StatementJSHelper;
 109 };
 110
 111 inline nsISupports* ToSupports(Statement* p) {
 112   return NS_ISUPPORTS_CAST(mozIStorageStatement*, p);
 113 }
 114
 115 }  // namespace storage
 116 }  // namespace mozilla
 117
 118 #endif  // mozStorageStatement_h