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
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_WEBDATA_COMMON_WEB_DATABASE_H_
#define COMPONENTS_WEBDATA_COMMON_WEB_DATABASE_H_
#include <map>
#include "base/macros.h"
#include "components/webdata/common/web_database_table.h"
#include "components/webdata/common/webdata_export.h"
#include "sql/connection.h"
#include "sql/init_status.h"
#include "sql/meta_table.h"
namespace base {
class FilePath;
}
// This class manages a SQLite database that stores various web page meta data.
class WEBDATA_EXPORT WebDatabase {
public:
enum State {
COMMIT_NOT_NEEDED,
COMMIT_NEEDED
};
// Exposed publicly so the keyword table can access it.
static const int kCurrentVersionNumber;
// The newest version of the database Chrome will NOT try to migrate.
static const int kDeprecatedVersionNumber;
WebDatabase();
virtual ~WebDatabase();
// Adds a database table. Ownership remains with the caller, which
// must ensure that the lifetime of |table| exceeds this object's
// lifetime. Must only be called before Init.
void AddTable(WebDatabaseTable* table);
// Retrieves a table based on its |key|.
WebDatabaseTable* GetTable(WebDatabaseTable::TypeKey key);
// Call before Init() to set the error callback to be used for the
// underlying database connection.
void set_error_callback(
const sql::Connection::ErrorCallback& error_callback) {
db_.set_error_callback(error_callback);
}
// Initialize the database given a name. The name defines where the SQLite
// file is. If this returns an error code, no other method should be called.
//
// Before calling this method, you must call AddTable for any
// WebDatabaseTable objects that are supposed to participate in
// managing the database.
sql::InitStatus Init(const base::FilePath& db_name);
// Transactions management
void BeginTransaction();
void CommitTransaction();
std::string GetDiagnosticInfo(int extended_error, sql::Statement* statement);
// Exposed for testing only.
sql::Connection* GetSQLConnection();
private:
// Used by |Init()| to migration database schema from older versions to
// current version.
sql::InitStatus MigrateOldVersionsAsNeeded();
// Migrates this database to |version|. Returns false if there was
// migration work to do and it failed, true otherwise.
//
// Implementations may set |*update_compatible_version| to true if
// the compatible version should be changed to |version|.
// Implementations should otherwise not modify this parameter.
bool MigrateToVersion(int version,
bool* update_compatible_version);
// Migration method for version 58.
bool MigrateToVersion58DropWebAppsAndIntents();
sql::Connection db_;
sql::MetaTable meta_table_;
// Map of all the different tables that have been added to this
// object. Non-owning.
typedef std::map<WebDatabaseTable::TypeKey, WebDatabaseTable*> TableMap;
TableMap tables_;
DISALLOW_COPY_AND_ASSIGN(WebDatabase);
};
#endif // COMPONENTS_WEBDATA_COMMON_WEB_DATABASE_H_
|
