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
|
/*
* Copyright (C) 2011 Google Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef THIRD_PARTY_BLINK_RENDERER_MODULES_INDEXEDDB_IDB_KEY_H_
#define THIRD_PARTY_BLINK_RENDERER_MODULES_INDEXEDDB_IDB_KEY_H_
#include <memory>
#include <utility>
#include "base/macros.h"
#include "base/memory/ptr_util.h"
#include "base/memory/scoped_refptr.h"
#include "third_party/blink/public/mojom/indexeddb/indexeddb.mojom-shared.h"
#include "third_party/blink/renderer/modules/modules_export.h"
#include "third_party/blink/renderer/platform/wtf/allocator/allocator.h"
#include "third_party/blink/renderer/platform/wtf/forward.h"
#include "third_party/blink/renderer/platform/wtf/shared_buffer.h"
#include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"
#include "third_party/blink/renderer/platform/wtf/vector.h"
namespace blink {
// An IndexedDB primary or index key.
//
// The IndexedDB backing store regards script values written as object store
// record values as fairly opaque data (see IDBValue and IDBValueWrapping).
// However, it needs a fair amount of visibility into script values used as
// primary keys and index keys. For this reason, keys are represented using a
// dedicated data type that fully exposes its contents to the backing store.
class MODULES_EXPORT IDBKey {
USING_FAST_MALLOC(IDBKey);
public:
typedef Vector<std::unique_ptr<IDBKey>> KeyArray;
static std::unique_ptr<IDBKey> CreateInvalid() {
return base::WrapUnique(new IDBKey());
}
static std::unique_ptr<IDBKey> CreateNone() {
return base::WrapUnique(new IDBKey(mojom::IDBKeyType::None));
}
static std::unique_ptr<IDBKey> CreateNumber(double number) {
return base::WrapUnique(new IDBKey(mojom::IDBKeyType::Number, number));
}
static std::unique_ptr<IDBKey> CreateBinary(
scoped_refptr<SharedBuffer> binary) {
return base::WrapUnique(new IDBKey(std::move(binary)));
}
static std::unique_ptr<IDBKey> CreateString(const String& string) {
return base::WrapUnique(new IDBKey(string));
}
static std::unique_ptr<IDBKey> CreateDate(double date) {
return base::WrapUnique(new IDBKey(mojom::IDBKeyType::Date, date));
}
static std::unique_ptr<IDBKey> CreateArray(KeyArray array) {
return base::WrapUnique(new IDBKey(std::move(array)));
}
static std::unique_ptr<IDBKey> Clone(const std::unique_ptr<IDBKey>& rkey_in) {
return IDBKey::Clone(rkey_in.get());
}
static std::unique_ptr<IDBKey> Clone(const IDBKey* rkey);
~IDBKey();
mojom::IDBKeyType GetType() const { return type_; }
bool IsValid() const;
const KeyArray& Array() const {
DCHECK_EQ(type_, mojom::IDBKeyType::Array);
return array_;
}
scoped_refptr<SharedBuffer> Binary() const {
DCHECK_EQ(type_, mojom::IDBKeyType::Binary);
return binary_;
}
const String& GetString() const {
DCHECK_EQ(type_, mojom::IDBKeyType::String);
return string_;
}
double Date() const {
DCHECK_EQ(type_, mojom::IDBKeyType::Date);
return number_;
}
double Number() const {
DCHECK_EQ(type_, mojom::IDBKeyType::Number);
return number_;
}
int Compare(const IDBKey* other) const;
bool IsLessThan(const IDBKey* other) const;
bool IsEqual(const IDBKey* other) const;
size_t SizeEstimate() const { return size_estimate_; }
// Returns a new key array with invalid keys and duplicates removed.
//
// The items in the key array are moved out of the given IDBKey, which must be
// an array. For this reason, the method is a static method that receives its
// argument via an std::unique_ptr.
//
// The return value will be pasesd to the backing store, which requires
// Web types. Returning the correct types directly avoids copying later on
// (wasted CPU cycles and code size).
static Vector<std::unique_ptr<IDBKey>> ToMultiEntryArray(
std::unique_ptr<IDBKey> array_key);
private:
DISALLOW_COPY_AND_ASSIGN(IDBKey);
IDBKey();
IDBKey(mojom::IDBKeyType type);
IDBKey(mojom::IDBKeyType type, double number);
explicit IDBKey(const String& value);
explicit IDBKey(scoped_refptr<SharedBuffer> value);
explicit IDBKey(KeyArray key_array);
mojom::IDBKeyType type_;
KeyArray array_;
scoped_refptr<SharedBuffer> binary_;
const String string_;
const double number_ = 0;
// Initialized in IDBKey constructors based on key type and value size (see
// idb_key.cc). Returned via SizeEstimate() and used in IndexedDB code to
// verify that a given key is small enough to pass over IPC.
size_t size_estimate_;
};
// An index id, and corresponding set of keys to insert.
struct IDBIndexKeys {
int64_t id;
Vector<std::unique_ptr<IDBKey>> keys;
};
} // namespace blink
#endif // THIRD_PARTY_BLINK_RENDERER_MODULES_INDEXEDDB_IDB_KEY_H_
|
