diff -r 000000000000 -r 4f2f89ce4247 WebCore/storage/SQLTransaction.h --- /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 +#include +#include +#include + +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 { +public: + virtual ~SQLTransactionWrapper() { } + virtual bool performPreflight(SQLTransaction*) = 0; + virtual bool performPostflight(SQLTransaction*) = 0; + + virtual SQLError* sqlError() const = 0; +}; + +class SQLTransaction : public ThreadSafeShared { +public: + static PassRefPtr create(Database*, PassRefPtr, PassRefPtr, + PassRefPtr, PassRefPtr, bool readOnly = false); + + ~SQLTransaction(); + + void executeSQL(const String& sqlStatement, const Vector& arguments, + PassRefPtr, PassRefPtr, ExceptionCode&); + + void lockAcquired(); + bool performNextStep(); + void performPendingCallback(); + + Database* database() { return m_database.get(); } + bool isReadOnly() { return m_readOnly; } + void notifyDatabaseThreadIsShuttingDown(); + +private: + SQLTransaction(Database*, PassRefPtr, PassRefPtr, + PassRefPtr, PassRefPtr, bool readOnly); + + typedef void (SQLTransaction::*TransactionStepMethod)(); + TransactionStepMethod m_nextStep; + + void enqueueStatement(PassRefPtr); + + 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 m_currentStatement; + + bool m_executeSqlAllowed; + + RefPtr m_database; + RefPtr m_wrapper; + RefPtr m_callback; + RefPtr m_successCallback; + RefPtr m_errorCallback; + RefPtr m_transactionError; + bool m_shouldRetryCurrentStatement; + bool m_modifiedDatabase; + bool m_lockAcquired; + bool m_readOnly; + + Mutex m_statementMutex; + Deque > m_statementQueue; + + OwnPtr m_sqliteTransaction; +}; + +} // namespace WebCore + +#endif + +#endif // SQLTransaction_h