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
|
// Copyright (c) 2009 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 APP_SQL_META_TABLE_H_
#define APP_SQL_META_TABLE_H_
#pragma once
#include <string>
#include "base/basictypes.h"
namespace sql {
class Connection;
class Statement;
class MetaTable {
public:
// Returns true if the 'meta' table exists.
static bool DoesTableExist(Connection* db);
MetaTable();
~MetaTable();
// Initializes the MetaTableHelper, creating the meta table if necessary. For
// new tables, it will initialize the version number to |version| and the
// compatible version number to |compatible_version|.
bool Init(Connection* db, int version, int compatible_version);
// Resets this MetaTable object, making another call to Init() possible.
void Reset();
// The version number of the database. This should be the version number of
// the creator of the file. The version number will be 0 if there is no
// previously set version number.
//
// See also Get/SetCompatibleVersionNumber().
void SetVersionNumber(int version);
int GetVersionNumber();
// The compatible version number is the lowest version of the code that this
// database can be read by. If there are minor changes or additions, old
// versions of the code can still work with the database without failing.
//
// For example, if an optional column is added to a table in version 3, the
// new code will set the version to 3, and the compatible version to 2, since
// the code expecting version 2 databases can still read and write the table.
//
// Rule of thumb: check the version number when you're upgrading, but check
// the compatible version number to see if you can read the file at all. If
// it's larger than you code is expecting, fail.
//
// The compatible version number will be 0 if there is no previously set
// compatible version number.
void SetCompatibleVersionNumber(int version);
int GetCompatibleVersionNumber();
// Set the given arbitrary key with the given data. Returns true on success.
bool SetValue(const char* key, const std::string& value);
bool SetValue(const char* key, int value);
bool SetValue(const char* key, int64 value);
// Retrieves the value associated with the given key. This will use sqlite's
// type conversion rules. It will return true on success.
bool GetValue(const char* key, std::string* value);
bool GetValue(const char* key, int* value);
bool GetValue(const char* key, int64* value);
private:
// Conveniences to prepare the two types of statements used by
// MetaTableHelper.
bool PrepareSetStatement(Statement* statement, const char* key);
bool PrepareGetStatement(Statement* statement, const char* key);
Connection* db_;
DISALLOW_COPY_AND_ASSIGN(MetaTable);
};
} // namespace sql
#endif // APP_SQL_META_TABLE_H_
|
