WebCore/storage/SQLTransaction.h
changeset 0 4f2f89ce4247
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/WebCore/storage/SQLTransaction.h	Fri Sep 17 09:02:29 2010 +0300
@@ -0,0 +1,138 @@
+/*
+ * Copyright (C) 2007 Apple Inc. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1.  Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ * 2.  Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in the
+ *     documentation and/or other materials provided with the distribution.
+ * 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of
+ *     its contributors may be used to endorse or promote products derived
+ *     from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
+ * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+#ifndef SQLTransaction_h
+#define SQLTransaction_h
+
+#if ENABLE(DATABASE)
+
+#include "ExceptionCode.h"
+#include "SQLStatement.h"
+#include <wtf/Deque.h>
+#include <wtf/Forward.h>
+#include <wtf/ThreadSafeShared.h>
+#include <wtf/Vector.h>
+
+namespace WebCore {
+
+class Database;
+class SQLError;
+class SQLiteTransaction;
+class SQLStatementCallback;
+class SQLStatementErrorCallback;
+class SQLTransaction;
+class SQLTransactionCallback;
+class SQLTransactionErrorCallback;
+class SQLValue;
+class String;
+class VoidCallback;
+
+class SQLTransactionWrapper : public ThreadSafeShared<SQLTransactionWrapper> {
+public:
+    virtual ~SQLTransactionWrapper() { }
+    virtual bool performPreflight(SQLTransaction*) = 0;
+    virtual bool performPostflight(SQLTransaction*) = 0;
+
+    virtual SQLError* sqlError() const = 0;
+};
+
+class SQLTransaction : public ThreadSafeShared<SQLTransaction> {
+public:
+    static PassRefPtr<SQLTransaction> create(Database*, PassRefPtr<SQLTransactionCallback>, PassRefPtr<SQLTransactionErrorCallback>,
+                                             PassRefPtr<VoidCallback>, PassRefPtr<SQLTransactionWrapper>, bool readOnly = false);
+
+    ~SQLTransaction();
+
+    void executeSQL(const String& sqlStatement, const Vector<SQLValue>& arguments,
+                    PassRefPtr<SQLStatementCallback>, PassRefPtr<SQLStatementErrorCallback>, ExceptionCode&);
+
+    void lockAcquired();
+    bool performNextStep();
+    void performPendingCallback();
+
+    Database* database() { return m_database.get(); }
+    bool isReadOnly() { return m_readOnly; }
+    void notifyDatabaseThreadIsShuttingDown();
+
+private:
+    SQLTransaction(Database*, PassRefPtr<SQLTransactionCallback>, PassRefPtr<SQLTransactionErrorCallback>,
+                   PassRefPtr<VoidCallback>, PassRefPtr<SQLTransactionWrapper>, bool readOnly);
+
+    typedef void (SQLTransaction::*TransactionStepMethod)();
+    TransactionStepMethod m_nextStep;
+
+    void enqueueStatement(PassRefPtr<SQLStatement>);
+
+    void checkAndHandleClosedDatabase();
+
+    void acquireLock();
+    void openTransactionAndPreflight();
+    void deliverTransactionCallback();
+    void scheduleToRunStatements();
+    void runStatements();
+    void getNextStatement();
+    bool runCurrentStatement();
+    void handleCurrentStatementError();
+    void deliverStatementCallback();
+    void deliverQuotaIncreaseCallback();
+    void postflightAndCommit();
+    void deliverSuccessCallback();
+    void cleanupAfterSuccessCallback();
+    void handleTransactionError(bool inCallback);
+    void deliverTransactionErrorCallback();
+    void cleanupAfterTransactionErrorCallback();
+
+#ifndef NDEBUG
+    static const char* debugStepName(TransactionStepMethod);
+#endif
+
+    RefPtr<SQLStatement> m_currentStatement;
+
+    bool m_executeSqlAllowed;
+
+    RefPtr<Database> m_database;
+    RefPtr<SQLTransactionWrapper> m_wrapper;
+    RefPtr<SQLTransactionCallback> m_callback;
+    RefPtr<VoidCallback> m_successCallback;
+    RefPtr<SQLTransactionErrorCallback> m_errorCallback;
+    RefPtr<SQLError> m_transactionError;
+    bool m_shouldRetryCurrentStatement;
+    bool m_modifiedDatabase;
+    bool m_lockAcquired;
+    bool m_readOnly;
+
+    Mutex m_statementMutex;
+    Deque<RefPtr<SQLStatement> > m_statementQueue;
+
+    OwnPtr<SQLiteTransaction> m_sqliteTransaction;
+};
+
+} // namespace WebCore
+
+#endif
+
+#endif // SQLTransaction_h