chromium/content/browser/blob_storage/file_backed_blob_factory_base.h

// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CONTENT_BROWSER_BLOB_STORAGE_FILE_BACKED_BLOB_FACTORY_BASE_H_
#define CONTENT_BROWSER_BLOB_STORAGE_FILE_BACKED_BLOB_FACTORY_BASE_H_

#include "content/browser/blob_storage/chrome_blob_storage_context.h"
#include "content/public/browser/render_frame_host.h"
#include "mojo/public/cpp/bindings/message.h"
#include "mojo/public/cpp/bindings/pending_receiver.h"
#include "storage/browser/blob/blob_storage_context.h"
#include "third_party/blink/public/mojom/blob/file_backed_blob_factory.mojom.h"
#include "url/gurl.h"

namespace content {

// `FileBackedBlobFactoryBase` is an abstract class to allow the registration of
// file backed blobs. The URL used for the registration should be the outermost
// document in the case the interface is used in a frame context. To be able to
// reliably retrieve the correct URL `FileBackedBlobFactoryFrameImpl` is a
// navigation-associated interface. This way the URL is retrieved in sync with
// the navigation.
//
// A `FileBackedBlobFactoryFrameImpl` object is created once per document and
// bound to a RenderFrameHost by a
// `FileBackedBlobFactoryFrameImpl::CreateForCurrentDocument()` call made from
// `RenderFrameHostImpl::BindAccessUrlRegistry`. The lifetime of
// `FileBackedBlobFactoryFrameImpl` is the same as that of document in the
// browser process.
//
// In the case the file is registered by a worker thread we cannot use the
// browser URL as the worker generally runs concurrent to the navigation.
// Therefore we fallback to the origin URL for file registrations triggered by
// workers. The `FileBackedBlobFactoryWorkerImpl` object is bound to the
// `RenderProcessHost`

// Both variants of this class live in the UI thread and all methods are meant
// to be called from the UI thread.
class CONTENT_EXPORT FileBackedBlobFactoryBase
    : public blink::mojom::FileBackedBlobFactory { … };

}  // namespace content

#endif  // CONTENT_BROWSER_BLOB_STORAGE_FILE_BACKED_BLOB_FACTORY_BASE_H_