summaryrefslogtreecommitdiffstats
path: root/dom/indexedDB/KeyPath.h
diff options
context:
space:
mode:
Diffstat (limited to 'dom/indexedDB/KeyPath.h')
-rw-r--r--dom/indexedDB/KeyPath.h104
1 files changed, 104 insertions, 0 deletions
diff --git a/dom/indexedDB/KeyPath.h b/dom/indexedDB/KeyPath.h
new file mode 100644
index 0000000000..23408b73c5
--- /dev/null
+++ b/dom/indexedDB/KeyPath.h
@@ -0,0 +1,104 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* 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 mozilla_dom_indexeddb_keypath_h__
+#define mozilla_dom_indexeddb_keypath_h__
+
+#include "mozilla/dom/BindingDeclarations.h"
+#include "mozilla/dom/Nullable.h"
+
+namespace mozilla {
+namespace dom {
+
+class OwningStringOrStringSequence;
+
+namespace indexedDB {
+
+class IndexMetadata;
+class Key;
+class ObjectStoreMetadata;
+
+class KeyPath {
+ // This private constructor is only to be used by IPDL-generated classes.
+ friend class IndexMetadata;
+ friend class ObjectStoreMetadata;
+
+ KeyPath() : mType(NONEXISTENT) { MOZ_COUNT_CTOR(KeyPath); }
+
+ public:
+ enum KeyPathType { NONEXISTENT, STRING, ARRAY, ENDGUARD };
+
+ void SetType(KeyPathType aType);
+
+ bool AppendStringWithValidation(const nsAString& aString);
+
+ explicit KeyPath(int aDummy) : mType(NONEXISTENT) { MOZ_COUNT_CTOR(KeyPath); }
+
+ KeyPath(KeyPath&& aOther) {
+ MOZ_COUNT_CTOR(KeyPath);
+ *this = std::move(aOther);
+ }
+ KeyPath& operator=(KeyPath&&) = default;
+
+ KeyPath(const KeyPath& aOther) {
+ MOZ_COUNT_CTOR(KeyPath);
+ *this = aOther;
+ }
+ KeyPath& operator=(const KeyPath&) = default;
+
+ MOZ_COUNTED_DTOR(KeyPath)
+
+ static Result<KeyPath, nsresult> Parse(const nsAString& aString);
+
+ static Result<KeyPath, nsresult> Parse(const Sequence<nsString>& aStrings);
+
+ static Result<KeyPath, nsresult> Parse(
+ const Nullable<OwningStringOrStringSequence>& aValue);
+
+ nsresult ExtractKey(JSContext* aCx, const JS::Value& aValue, Key& aKey) const;
+
+ nsresult ExtractKeyAsJSVal(JSContext* aCx, const JS::Value& aValue,
+ JS::Value* aOutVal) const;
+
+ typedef nsresult (*ExtractOrCreateKeyCallback)(JSContext* aCx,
+ void* aClosure);
+
+ nsresult ExtractOrCreateKey(JSContext* aCx, const JS::Value& aValue,
+ Key& aKey, ExtractOrCreateKeyCallback aCallback,
+ void* aClosure) const;
+
+ inline bool IsValid() const { return mType != NONEXISTENT; }
+
+ inline bool IsArray() const { return mType == ARRAY; }
+
+ inline bool IsString() const { return mType == STRING; }
+
+ inline bool IsEmpty() const {
+ return mType == STRING && mStrings[0].IsEmpty();
+ }
+
+ bool operator==(const KeyPath& aOther) const {
+ return mType == aOther.mType && mStrings == aOther.mStrings;
+ }
+
+ nsAutoString SerializeToString() const;
+ static KeyPath DeserializeFromString(const nsAString& aString);
+
+ nsresult ToJSVal(JSContext* aCx, JS::MutableHandle<JS::Value> aValue) const;
+ nsresult ToJSVal(JSContext* aCx, JS::Heap<JS::Value>& aValue) const;
+
+ bool IsAllowedForObjectStore(bool aAutoIncrement) const;
+
+ KeyPathType mType;
+
+ CopyableTArray<nsString> mStrings;
+};
+
+} // namespace indexedDB
+} // namespace dom
+} // namespace mozilla
+
+#endif // mozilla_dom_indexeddb_keypath_h__