2 * Copyright (C) 2012 Apple Inc. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution.
13 * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 #ifndef DatabaseManager_h
27 #define DatabaseManager_h
29 #include "modules/webdatabase/DatabaseBasicTypes.h"
30 #include "modules/webdatabase/DatabaseError.h"
31 #include "platform/heap/Handle.h"
32 #include "wtf/Assertions.h"
33 #include "wtf/HashMap.h"
34 #include "wtf/PassRefPtr.h"
35 #include "wtf/ThreadingPrimitives.h"
36 #include "wtf/text/WTFString.h"
40 class AbstractDatabaseServer;
42 class DatabaseBackendBase;
43 class DatabaseCallback;
44 class DatabaseContext;
46 class TaskSynchronizer;
49 class ExecutionContext;
51 typedef int ExceptionCode;
53 class DatabaseManager {
54 WTF_MAKE_NONCOPYABLE(DatabaseManager); WTF_MAKE_FAST_ALLOCATED;
56 static DatabaseManager& manager();
58 // These 2 methods are for DatabaseContext (un)registration, and should only
59 // be called by the DatabaseContext constructor and destructor.
60 void registerDatabaseContext(DatabaseContext*);
61 void unregisterDatabaseContext(DatabaseContext*);
64 void didConstructDatabaseContext();
65 void didDestructDatabaseContext();
67 void didConstructDatabaseContext() { }
68 void didDestructDatabaseContext() { }
71 static void throwExceptionForDatabaseError(DatabaseError, const String& errorMessage, ExceptionState&);
73 PassRefPtrWillBeRawPtr<Database> openDatabase(ExecutionContext*, const String& name, const String& expectedVersion, const String& displayName, unsigned long estimatedSize, PassOwnPtr<DatabaseCallback>, DatabaseError&, String& errorMessage);
74 PassRefPtrWillBeRawPtr<DatabaseSync> openDatabaseSync(ExecutionContext*, const String& name, const String& expectedVersion, const String& displayName, unsigned long estimatedSize, PassOwnPtr<DatabaseCallback>, DatabaseError&, String& errorMessage);
76 String fullPathForDatabase(SecurityOrigin*, const String& name, bool createIfDoesNotExist = true);
78 void closeDatabasesImmediately(const String& originIdentifier, const String& name);
80 void interruptAllDatabasesForContext(DatabaseContext*);
86 // This gets a DatabaseContext for the specified ExecutionContext.
87 // If one doesn't already exist, it will create a new one.
88 DatabaseContext* databaseContextFor(ExecutionContext*);
89 // This gets a DatabaseContext for the specified ExecutionContext if
90 // it already exist previously. Otherwise, it returns 0.
91 DatabaseContext* existingDatabaseContextFor(ExecutionContext*);
93 PassRefPtrWillBeRawPtr<DatabaseBackendBase> openDatabaseBackend(ExecutionContext*,
94 DatabaseType, const String& name, const String& expectedVersion, const String& displayName,
95 unsigned long estimatedSize, bool setVersionInNewDatabase, DatabaseError&, String& errorMessage);
97 static void logErrorMessage(ExecutionContext*, const String& message);
99 AbstractDatabaseServer* m_server;
101 // Access to the following fields require locking m_contextMapLock:
103 // We can't use PersistentHeapHashMap because multiple threads update the map.
104 typedef HashMap<ExecutionContext*, OwnPtr<Persistent<DatabaseContext> > > ContextMap;
106 typedef HashMap<ExecutionContext*, RefPtr<DatabaseContext> > ContextMap;
108 ContextMap m_contextMap;
110 int m_databaseContextRegisteredCount;
111 int m_databaseContextInstanceCount;
113 Mutex m_contextMapLock;
116 } // namespace WebCore
118 #endif // DatabaseManager_h