Use STL threading primitives in DatabaseDetails and DatabaseManager
[WebKit-https.git] / Source / WebCore / Modules / webdatabase / DatabaseManager.h
1 /*
2  * Copyright (C) 2012 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
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.
12  *
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. 
24  */
25
26 #ifndef DatabaseManager_h
27 #define DatabaseManager_h
28
29 #if ENABLE(SQL_DATABASE)
30
31 #include "DatabaseBasicTypes.h"
32 #include "DatabaseDetails.h"
33 #include "DatabaseError.h"
34 #include <wtf/Assertions.h>
35 #include <wtf/HashMap.h>
36 #include <wtf/HashSet.h>
37 #include <wtf/PassRefPtr.h>
38 #include <wtf/Threading.h>
39
40 namespace WebCore {
41
42 class AbstractDatabaseServer;
43 class Database;
44 class DatabaseBackendBase;
45 class DatabaseCallback;
46 class DatabaseContext;
47 class DatabaseManagerClient;
48 class DatabaseSync;
49 class DatabaseTaskSynchronizer;
50 class SecurityOrigin;
51 class ScriptExecutionContext;
52
53 class DatabaseManager {
54     WTF_MAKE_NONCOPYABLE(DatabaseManager); WTF_MAKE_FAST_ALLOCATED;
55 public:
56     static DatabaseManager& manager();
57
58     void initialize(const String& databasePath);
59     void setClient(DatabaseManagerClient*);
60     String databaseDirectoryPath() const;
61     void setDatabaseDirectoryPath(const String&);
62
63     bool isAvailable();
64     void setIsAvailable(bool);
65
66     // This gets a DatabaseContext for the specified ScriptExecutionContext.
67     // If one doesn't already exist, it will create a new one.
68     PassRefPtr<DatabaseContext> databaseContextFor(ScriptExecutionContext*);
69
70     // These 2 methods are for DatabaseContext (un)registration, and should only
71     // be called by the DatabaseContext constructor and destructor.
72     void registerDatabaseContext(DatabaseContext*);
73     void unregisterDatabaseContext(DatabaseContext*);
74
75 #if !ASSERT_DISABLED
76     void didConstructDatabaseContext();
77     void didDestructDatabaseContext();
78 #else
79     void didConstructDatabaseContext() { }
80     void didDestructDatabaseContext() { }
81 #endif
82
83     static ExceptionCode exceptionCodeForDatabaseError(DatabaseError);
84
85     PassRefPtr<Database> openDatabase(ScriptExecutionContext*, const String& name, const String& expectedVersion, const String& displayName, unsigned long estimatedSize, PassRefPtr<DatabaseCallback>, DatabaseError&);
86     PassRefPtr<DatabaseSync> openDatabaseSync(ScriptExecutionContext*, const String& name, const String& expectedVersion, const String& displayName, unsigned long estimatedSize, PassRefPtr<DatabaseCallback>, DatabaseError&);
87
88     bool hasOpenDatabases(ScriptExecutionContext*);
89     void stopDatabases(ScriptExecutionContext*, DatabaseTaskSynchronizer*);
90
91     String fullPathForDatabase(SecurityOrigin*, const String& name, bool createIfDoesNotExist = true);
92
93     bool hasEntryForOrigin(SecurityOrigin*);
94     void origins(Vector<RefPtr<SecurityOrigin>>& result);
95     bool databaseNamesForOrigin(SecurityOrigin*, Vector<String>& result);
96     DatabaseDetails detailsForNameAndOrigin(const String&, SecurityOrigin*);
97
98     unsigned long long usageForOrigin(SecurityOrigin*);
99     unsigned long long quotaForOrigin(SecurityOrigin*);
100
101     void setQuota(SecurityOrigin*, unsigned long long);
102
103     void deleteAllDatabases();
104     bool deleteOrigin(SecurityOrigin*);
105     bool deleteDatabase(SecurityOrigin*, const String& name);
106
107     void interruptAllDatabasesForContext(ScriptExecutionContext*);
108
109 private:
110     class ProposedDatabase {
111     public:
112         ProposedDatabase(DatabaseManager&, SecurityOrigin*,
113             const String& name, const String& displayName, unsigned long estimatedSize);
114         ~ProposedDatabase();
115
116         SecurityOrigin* origin() { return m_origin.get(); }
117         DatabaseDetails& details() { return m_details; }
118
119     private:
120         DatabaseManager& m_manager;
121         RefPtr<SecurityOrigin> m_origin;
122         DatabaseDetails m_details;
123     };
124
125     DatabaseManager();
126     ~DatabaseManager() { }
127
128     // This gets a DatabaseContext for the specified ScriptExecutionContext if
129     // it already exist previously. Otherwise, it returns 0.
130     PassRefPtr<DatabaseContext> existingDatabaseContextFor(ScriptExecutionContext*);
131
132     PassRefPtr<DatabaseBackendBase> openDatabaseBackend(ScriptExecutionContext*,
133         DatabaseType, const String& name, const String& expectedVersion, const String& displayName,
134         unsigned long estimatedSize, bool setVersionInNewDatabase, DatabaseError&, String& errorMessage);
135
136     void addProposedDatabase(ProposedDatabase*);
137     void removeProposedDatabase(ProposedDatabase*);
138
139     static void logErrorMessage(ScriptExecutionContext*, const String& message);
140
141     AbstractDatabaseServer* m_server;
142     DatabaseManagerClient* m_client;
143     bool m_databaseIsAvailable;
144
145     // Access to the following fields require locking m_lock below:
146     typedef HashMap<ScriptExecutionContext*, DatabaseContext*> ContextMap;
147     ContextMap m_contextMap;
148 #if !ASSERT_DISABLED
149     int m_databaseContextRegisteredCount;
150     int m_databaseContextInstanceCount;
151 #endif
152     HashSet<ProposedDatabase*> m_proposedDatabases;
153
154     // This mutex protects m_contextMap, and m_proposedDatabases.
155     std::mutex m_mutex;
156 };
157
158 } // namespace WebCore
159
160 #endif // ENABLE(SQL_DATABASE)
161
162 #endif // DatabaseManager_h