diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 01:47:29 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 01:47:29 +0000 |
commit | 0ebf5bdf043a27fd3dfb7f92e0cb63d88954c44d (patch) | |
tree | a31f07c9bcca9d56ce61e9a1ffd30ef350d513aa /dom/indexedDB/IndexedDatabase.h | |
parent | Initial commit. (diff) | |
download | firefox-esr-0ebf5bdf043a27fd3dfb7f92e0cb63d88954c44d.tar.xz firefox-esr-0ebf5bdf043a27fd3dfb7f92e0cb63d88954c44d.zip |
Adding upstream version 115.8.0esr.upstream/115.8.0esr
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'dom/indexedDB/IndexedDatabase.h')
-rw-r--r-- | dom/indexedDB/IndexedDatabase.h | 232 |
1 files changed, 232 insertions, 0 deletions
diff --git a/dom/indexedDB/IndexedDatabase.h b/dom/indexedDB/IndexedDatabase.h new file mode 100644 index 0000000000..6fdf641553 --- /dev/null +++ b/dom/indexedDB/IndexedDatabase.h @@ -0,0 +1,232 @@ +/* -*- 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_indexeddatabase_h__ +#define mozilla_dom_indexeddatabase_h__ + +#include "DatabaseFileInfoFwd.h" +#include "js/StructuredClone.h" +#include "mozilla/InitializedOnce.h" +#include "mozilla/Variant.h" +#include "nsCOMPtr.h" +#include "nsTArray.h" +#include "SafeRefPtr.h" + +namespace mozilla::dom { + +class Blob; +class IDBDatabase; + +namespace indexedDB { + +struct StructuredCloneFileBase { + enum FileType { + eBlob, + eMutableFile, + eStructuredClone, + eWasmBytecode, + eWasmCompiled, + eEndGuard + }; + + FileType Type() const { return mType; } + + protected: + explicit StructuredCloneFileBase(FileType aType) : mType{aType} {} + + FileType mType; +}; + +struct StructuredCloneFileChild : StructuredCloneFileBase { + StructuredCloneFileChild(const StructuredCloneFileChild&) = delete; + StructuredCloneFileChild& operator=(const StructuredCloneFileChild&) = delete; +#ifdef NS_BUILD_REFCNT_LOGGING + // In IndexedDatabaseInlines.h + StructuredCloneFileChild(StructuredCloneFileChild&&); +#else + StructuredCloneFileChild(StructuredCloneFileChild&&) = default; +#endif + StructuredCloneFileChild& operator=(StructuredCloneFileChild&&) = delete; + + // In IndexedDatabaseInlines.h + ~StructuredCloneFileChild(); + + // In IndexedDatabaseInlines.h + explicit StructuredCloneFileChild(FileType aType); + + // In IndexedDatabaseInlines.h + StructuredCloneFileChild(FileType aType, RefPtr<Blob> aBlob); + + const dom::Blob& Blob() const { return *mContents->as<RefPtr<dom::Blob>>(); } + + // XXX This is currently used for a number of reasons. Bug 1620560 will remove + // the need for one of them, but the uses of do_GetWeakReference in + // IDBDatabase::GetOrCreateFileActorForBlob and WrapAsJSObject in + // CopyingStructuredCloneReadCallback are probably harder to change. + dom::Blob& MutableBlob() const { return *mContents->as<RefPtr<dom::Blob>>(); } + + // In IndexedDatabaseInlines.h + RefPtr<dom::Blob> BlobPtr() const; + + bool HasBlob() const { return mContents->is<RefPtr<dom::Blob>>(); } + + private: + InitializedOnce<const Variant<Nothing, RefPtr<dom::Blob>>> mContents; +}; + +struct StructuredCloneFileParent : StructuredCloneFileBase { + StructuredCloneFileParent(const StructuredCloneFileParent&) = delete; + StructuredCloneFileParent& operator=(const StructuredCloneFileParent&) = + delete; +#ifdef NS_BUILD_REFCNT_LOGGING + // In IndexedDatabaseInlines.h + StructuredCloneFileParent(StructuredCloneFileParent&&); +#else + StructuredCloneFileParent(StructuredCloneFileParent&&) = default; +#endif + StructuredCloneFileParent& operator=(StructuredCloneFileParent&&) = delete; + + // In IndexedDatabaseInlines.h + StructuredCloneFileParent(FileType aType, + SafeRefPtr<DatabaseFileInfo> aFileInfo); + + // In IndexedDatabaseInlines.h + ~StructuredCloneFileParent(); + + // XXX This is used for a schema upgrade hack in UpgradeSchemaFrom19_0To20_0. + // When this is eventually removed, this function can be removed, and mType + // can be declared const in the base class. + void MutateType(FileType aNewType) { mType = aNewType; } + + const DatabaseFileInfo& FileInfo() const { return ***mContents; } + + // In IndexedDatabaseInlines.h + SafeRefPtr<DatabaseFileInfo> FileInfoPtr() const; + + private: + InitializedOnce<const Maybe<SafeRefPtr<DatabaseFileInfo>>> mContents; +}; + +struct StructuredCloneReadInfoBase { + // In IndexedDatabaseInlines.h + explicit StructuredCloneReadInfoBase(JSStructuredCloneData&& aData) + : mData{std::move(aData)} {} + + const JSStructuredCloneData& Data() const { return mData; } + JSStructuredCloneData ReleaseData() { return std::move(mData); } + + private: + JSStructuredCloneData mData; +}; + +template <typename StructuredCloneFileT> +struct StructuredCloneReadInfo : StructuredCloneReadInfoBase { + using StructuredCloneFile = StructuredCloneFileT; + + // In IndexedDatabaseInlines.h + explicit StructuredCloneReadInfo(JS::StructuredCloneScope aScope); + + // In IndexedDatabaseInlines.h + StructuredCloneReadInfo(); + + // In IndexedDatabaseInlines.h + StructuredCloneReadInfo(JSStructuredCloneData&& aData, + nsTArray<StructuredCloneFile> aFiles); + +#ifdef NS_BUILD_REFCNT_LOGGING + // In IndexedDatabaseInlines.h + ~StructuredCloneReadInfo(); + + // In IndexedDatabaseInlines.h + // + // This custom implementation of the move ctor is only necessary because of + // MOZ_COUNT_CTOR. It is less efficient as the compiler-generated move ctor, + // since it unnecessarily clears elements on the source. + StructuredCloneReadInfo(StructuredCloneReadInfo&& aOther) noexcept; +#else + StructuredCloneReadInfo(StructuredCloneReadInfo&& aOther) = default; +#endif + StructuredCloneReadInfo& operator=(StructuredCloneReadInfo&& aOther) = + default; + + StructuredCloneReadInfo(const StructuredCloneReadInfo& aOther) = delete; + StructuredCloneReadInfo& operator=(const StructuredCloneReadInfo& aOther) = + delete; + + // In IndexedDatabaseInlines.h + size_t Size() const; + + // XXX This is only needed for a schema upgrade (UpgradeSchemaFrom19_0To20_0). + // If support for older schemas is dropped, we can probably remove this method + // and make mFiles InitializedOnce. + StructuredCloneFile& MutableFile(const size_t aIndex) { + return mFiles[aIndex]; + } + const nsTArray<StructuredCloneFile>& Files() const { return mFiles; } + + nsTArray<StructuredCloneFile> ReleaseFiles() { return std::move(mFiles); } + + bool HasFiles() const { return !mFiles.IsEmpty(); } + + private: + nsTArray<StructuredCloneFile> mFiles; +}; + +struct StructuredCloneReadInfoChild + : StructuredCloneReadInfo<StructuredCloneFileChild> { + inline StructuredCloneReadInfoChild(JSStructuredCloneData&& aData, + nsTArray<StructuredCloneFileChild> aFiles, + IDBDatabase* aDatabase); + + IDBDatabase* Database() const { return mDatabase; } + + private: + IDBDatabase* mDatabase; +}; + +// This is only defined in the header file to satisfy the clang-plugin static +// analysis, it could be placed in ActorsParent.cpp otherwise. +struct StructuredCloneReadInfoParent + : StructuredCloneReadInfo<StructuredCloneFileParent> { + StructuredCloneReadInfoParent(JSStructuredCloneData&& aData, + nsTArray<StructuredCloneFileParent> aFiles, + bool aHasPreprocessInfo) + : StructuredCloneReadInfo{std::move(aData), std::move(aFiles)}, + mHasPreprocessInfo{aHasPreprocessInfo} {} + + bool HasPreprocessInfo() const { return mHasPreprocessInfo; } + + private: + bool mHasPreprocessInfo; +}; + +template <typename StructuredCloneReadInfo> +JSObject* CommonStructuredCloneReadCallback( + JSContext* aCx, JSStructuredCloneReader* aReader, + const JS::CloneDataPolicy& aCloneDataPolicy, uint32_t aTag, uint32_t aData, + StructuredCloneReadInfo* aCloneReadInfo, IDBDatabase* aDatabase); + +template <typename StructuredCloneReadInfoType> +JSObject* StructuredCloneReadCallback( + JSContext* aCx, JSStructuredCloneReader* aReader, + const JS::CloneDataPolicy& aCloneDataPolicy, uint32_t aTag, uint32_t aData, + void* aClosure); + +} // namespace indexedDB +} // namespace mozilla::dom + +MOZ_DECLARE_RELOCATE_USING_MOVE_CONSTRUCTOR( + mozilla::dom::indexedDB::StructuredCloneReadInfo< + mozilla::dom::indexedDB::StructuredCloneFileChild>); +MOZ_DECLARE_RELOCATE_USING_MOVE_CONSTRUCTOR( + mozilla::dom::indexedDB::StructuredCloneReadInfo< + mozilla::dom::indexedDB::StructuredCloneFileParent>); +MOZ_DECLARE_RELOCATE_USING_MOVE_CONSTRUCTOR( + mozilla::dom::indexedDB::StructuredCloneReadInfoChild); +MOZ_DECLARE_RELOCATE_USING_MOVE_CONSTRUCTOR( + mozilla::dom::indexedDB::StructuredCloneReadInfoParent); + +#endif // mozilla_dom_indexeddatabase_h__ |