/* * Copyright (C) 2010 Google 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. * * 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 IDBDatabase_h #define IDBDatabase_h #include "bindings/core/v8/ScriptState.h" #include "bindings/modules/v8/UnionTypesModules.h" #include "core/dom/ActiveDOMObject.h" #include "core/dom/DOMStringList.h" #include "modules/EventModules.h" #include "modules/EventTargetModules.h" #include "modules/ModulesExport.h" #include "modules/indexeddb/IDBDatabaseCallbacks.h" #include "modules/indexeddb/IDBHistograms.h" #include "modules/indexeddb/IDBMetadata.h" #include "modules/indexeddb/IDBObjectStore.h" #include "modules/indexeddb/IDBObjectStoreParameters.h" #include "modules/indexeddb/IDBTransaction.h" #include "modules/indexeddb/IndexedDB.h" #include "platform/heap/Handle.h" #include "public/platform/modules/indexeddb/WebIDBDatabase.h" #include "wtf/OwnPtr.h" #include "wtf/PassOwnPtr.h" #include "wtf/PassRefPtr.h" #include "wtf/RefPtr.h" namespace blink { class DOMException; class ExceptionState; class ExecutionContext; class MODULES_EXPORT IDBDatabase final : public RefCountedGarbageCollectedEventTargetWithInlineData , public ActiveDOMObject { REFCOUNTED_GARBAGE_COLLECTED_EVENT_TARGET(IDBDatabase); WILL_BE_USING_GARBAGE_COLLECTED_MIXIN(IDBDatabase); DEFINE_WRAPPERTYPEINFO(); public: static IDBDatabase* create(ExecutionContext*, PassOwnPtr, IDBDatabaseCallbacks*); ~IDBDatabase() override; DECLARE_VIRTUAL_TRACE(); void setMetadata(const IDBDatabaseMetadata& metadata) { m_metadata = metadata; } void indexCreated(int64_t objectStoreId, const IDBIndexMetadata&); void indexDeleted(int64_t objectStoreId, int64_t indexId); void transactionCreated(IDBTransaction*); void transactionFinished(const IDBTransaction*); // Implement the IDL const String& name() const { return m_metadata.name; } unsigned long long version() const { return m_metadata.version; } PassRefPtrWillBeRawPtr objectStoreNames() const; IDBObjectStore* createObjectStore(const String& name, const IDBObjectStoreParameters& options, ExceptionState& exceptionState) { return createObjectStore(name, IDBKeyPath(options.keyPath()), options.autoIncrement(), exceptionState); } IDBTransaction* transaction(ScriptState*, const StringOrStringSequenceOrDOMStringList&, const String& mode, ExceptionState&); void deleteObjectStore(const String& name, ExceptionState&); void close(); DEFINE_ATTRIBUTE_EVENT_LISTENER(abort); DEFINE_ATTRIBUTE_EVENT_LISTENER(close); DEFINE_ATTRIBUTE_EVENT_LISTENER(error); DEFINE_ATTRIBUTE_EVENT_LISTENER(versionchange); // IDBDatabaseCallbacks void onVersionChange(int64_t oldVersion, int64_t newVersion); void onAbort(int64_t, DOMException*); void onComplete(int64_t); // ActiveDOMObject bool hasPendingActivity() const override; void stop() override; // EventTarget const AtomicString& interfaceName() const override; ExecutionContext* executionContext() const override; bool isClosePending() const { return m_closePending; } void forceClose(); const IDBDatabaseMetadata& metadata() const { return m_metadata; } void enqueueEvent(PassRefPtrWillBeRawPtr); int64_t findObjectStoreId(const String& name) const; bool containsObjectStore(const String& name) const { return findObjectStoreId(name) != IDBObjectStoreMetadata::InvalidId; } // Will return nullptr if this database is stopped. WebIDBDatabase* backend() const { return m_backend.get(); } static int64_t nextTransactionId(); static const char indexDeletedErrorMessage[]; static const char isKeyCursorErrorMessage[]; static const char noKeyOrKeyRangeErrorMessage[]; static const char noSuchIndexErrorMessage[]; static const char noSuchObjectStoreErrorMessage[]; static const char noValueErrorMessage[]; static const char notValidKeyErrorMessage[]; static const char notVersionChangeTransactionErrorMessage[]; static const char objectStoreDeletedErrorMessage[]; static const char requestNotFinishedErrorMessage[]; static const char sourceDeletedErrorMessage[]; static const char transactionFinishedErrorMessage[]; static const char transactionInactiveErrorMessage[]; static const char transactionReadOnlyErrorMessage[]; static const char databaseClosedErrorMessage[]; static void recordApiCallsHistogram(IndexedDatabaseMethods); protected: // EventTarget bool dispatchEventInternal(PassRefPtrWillBeRawPtr) override; private: IDBDatabase(ExecutionContext*, PassOwnPtr, IDBDatabaseCallbacks*); IDBObjectStore* createObjectStore(const String& name, const IDBKeyPath&, bool autoIncrement, ExceptionState&); void closeConnection(); IDBDatabaseMetadata m_metadata; OwnPtr m_backend; Member m_versionChangeTransaction; HeapHashMap> m_transactions; bool m_closePending = false; bool m_contextStopped = false; // Keep track of the versionchange events waiting to be fired on this // database so that we can cancel them if the database closes. WillBeHeapVector> m_enqueuedEvents; Member m_databaseCallbacks; }; } // namespace blink #endif // IDBDatabase_h