1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
* vim: sw=2 ts=2 et lcs=trail\:.,tab\:>~ :
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef MOZSTORAGESERVICE_H
#define MOZSTORAGESERVICE_H
#include "nsCOMPtr.h"
#include "nsICollation.h"
#include "nsIFile.h"
#include "nsIMemoryReporter.h"
#include "nsIObserver.h"
#include "nsTArray.h"
#include "mozilla/Mutex.h"
#include "mozIStorageService.h"
class nsIMemoryReporter;
class nsIXPConnect;
struct sqlite3_vfs;
namespace mozilla {
namespace storage {
class Connection;
class Service : public mozIStorageService
, public nsIObserver
, public nsIMemoryReporter
{
public:
/**
* Initializes the service. This must be called before any other function!
*/
nsresult initialize();
/**
* Compares two strings using the Service's locale-aware collation.
*
* @param aStr1
* The string to be compared against aStr2.
* @param aStr2
* The string to be compared against aStr1.
* @param aComparisonStrength
* The sorting strength, one of the nsICollation constants.
* @return aStr1 - aStr2. That is, if aStr1 < aStr2, returns a negative
* number. If aStr1 > aStr2, returns a positive number. If
* aStr1 == aStr2, returns 0.
*/
int localeCompareStrings(const nsAString &aStr1,
const nsAString &aStr2,
int32_t aComparisonStrength);
static Service *getSingleton();
NS_DECL_THREADSAFE_ISUPPORTS
NS_DECL_MOZISTORAGESERVICE
NS_DECL_NSIOBSERVER
NS_DECL_NSIMEMORYREPORTER
/**
* Obtains an already AddRefed pointer to XPConnect. This is used by
* language helpers.
*/
static already_AddRefed<nsIXPConnect> getXPConnect();
/**
* Obtains the cached data for the toolkit.storage.synchronous preference.
*/
static int32_t getSynchronousPref();
/**
* Obtains the default page size for this platform. The default value is
* specified in the SQLite makefile (SQLITE_DEFAULT_PAGE_SIZE) but it may be
* overriden with the PREF_TS_PAGESIZE hidden preference.
*/
static int32_t getDefaultPageSize()
{
return sDefaultPageSize;
}
/**
* Returns a boolean value indicating whether or not the given page size is
* valid (currently understood as a power of 2 between 512 and 65536).
*/
static bool pageSizeIsValid(int32_t aPageSize)
{
return aPageSize == 512 || aPageSize == 1024 || aPageSize == 2048 ||
aPageSize == 4096 || aPageSize == 8192 || aPageSize == 16384 ||
aPageSize == 32768 || aPageSize == 65536;
}
/**
* Registers the connection with the storage service. Connections are
* registered so they can be iterated over.
*
* @pre mRegistrationMutex is not held
*
* @param aConnection
* The connection to register.
*/
void registerConnection(Connection *aConnection);
/**
* Unregisters the connection with the storage service.
*
* @pre mRegistrationMutex is not held
*
* @param aConnection
* The connection to unregister.
*/
void unregisterConnection(Connection *aConnection);
/**
* Gets the list of open connections. Note that you must test each
* connection with mozIStorageConnection::connectionReady before doing
* anything with it, and skip it if it's not ready.
*
* @pre mRegistrationMutex is not held
*
* @param aConnections
* An inout param; it is cleared and the connections are appended to
* it.
* @return The open connections.
*/
void getConnections(nsTArray<RefPtr<Connection> >& aConnections);
private:
Service();
virtual ~Service();
/**
* Used for 1) locking around calls when initializing connections so that we
* can ensure that the state of sqlite3_enable_shared_cache is sane and 2)
* synchronizing access to mLocaleCollation.
*/
Mutex mMutex;
sqlite3_vfs *mSqliteVFS;
/**
* Protects mConnections.
*/
Mutex mRegistrationMutex;
/**
* The list of connections we have created. Modifications to it are
* protected by |mRegistrationMutex|.
*/
nsTArray<RefPtr<Connection> > mConnections;
/**
* Frees as much heap memory as possible from all of the known open
* connections.
*/
void minimizeMemory();
/**
* Shuts down the storage service, freeing all of the acquired resources.
*/
void shutdown();
/**
* Lazily creates and returns a collation created from the application's
* locale that all statements of all Connections of this Service may use.
* Since the collation's lifetime is that of the Service and no statement may
* execute outside the lifetime of the Service, this method returns a raw
* pointer.
*/
nsICollation *getLocaleCollation();
/**
* Lazily created collation that all statements of all Connections of this
* Service may use. The collation is created from the application's locale.
*
* @note Collation implementations are platform-dependent and in general not
* thread-safe. Access to this collation should be synchronized.
*/
nsCOMPtr<nsICollation> mLocaleCollation;
nsCOMPtr<nsIFile> mProfileStorageFile;
nsCOMPtr<nsIMemoryReporter> mStorageSQLiteReporter;
static Service *gService;
static nsIXPConnect *sXPConnect;
static int32_t sSynchronousPref;
static int32_t sDefaultPageSize;
};
} // namespace storage
} // namespace mozilla
#endif /* MOZSTORAGESERVICE_H */
|
