зеркало из https://github.com/mozilla/gecko-dev.git
115 строки
4.0 KiB
C++
115 строки
4.0 KiB
C++
/* -*- 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_ClientManager_h
|
|
#define _mozilla_dom_ClientManager_h
|
|
|
|
#include "mozilla/dom/ClientOpPromise.h"
|
|
#include "mozilla/dom/ClientThing.h"
|
|
|
|
class nsIPrincipal;
|
|
|
|
namespace mozilla {
|
|
namespace ipc {
|
|
class PBackgroundChild;
|
|
class PrincipalInfo;
|
|
} // namespace ipc
|
|
namespace dom {
|
|
|
|
class ClientClaimArgs;
|
|
class ClientGetInfoAndStateArgs;
|
|
class ClientHandle;
|
|
class ClientInfo;
|
|
class ClientManagerChild;
|
|
class ClientMatchAllArgs;
|
|
class ClientNavigateArgs;
|
|
class ClientOpConstructorArgs;
|
|
class ClientOpenWindowArgs;
|
|
class ClientSource;
|
|
enum class ClientType : uint8_t;
|
|
class WorkerPrivate;
|
|
|
|
// The ClientManager provides a per-thread singleton interface workering
|
|
// with the client subsystem. It allows globals to create ClientSource
|
|
// objects. It allows other parts of the system to attach to this globals
|
|
// by creating ClientHandle objects. The ClientManager also provides
|
|
// methods for querying the list of clients active in the system.
|
|
class ClientManager final : public ClientThing<ClientManagerChild> {
|
|
friend class ClientManagerChild;
|
|
friend class ClientSource;
|
|
|
|
ClientManager();
|
|
~ClientManager();
|
|
|
|
// Utility method to trigger a shutdown of the ClientManager. This
|
|
// is called in various error conditions or when the last reference
|
|
// is dropped.
|
|
void Shutdown();
|
|
|
|
UniquePtr<ClientSource> CreateSourceInternal(
|
|
ClientType aType, nsISerialEventTarget* aEventTarget,
|
|
const mozilla::ipc::PrincipalInfo& aPrincipal);
|
|
|
|
already_AddRefed<ClientHandle> CreateHandleInternal(
|
|
const ClientInfo& aClientInfo, nsISerialEventTarget* aSerialEventTarget);
|
|
|
|
// Utility method to perform an IPC operation. This will create a
|
|
// PClientManagerOp actor tied to a MozPromise. The promise will
|
|
// resolve or reject with the result of the remote operation.
|
|
MOZ_MUST_USE RefPtr<ClientOpPromise> StartOp(
|
|
const ClientOpConstructorArgs& aArgs,
|
|
nsISerialEventTarget* aSerialEventTarget);
|
|
|
|
// Get or create the TLS singleton. Currently this is only used
|
|
// internally and external code indirectly calls it by invoking
|
|
// static methods.
|
|
static already_AddRefed<ClientManager> GetOrCreateForCurrentThread();
|
|
|
|
// Private methods called by ClientSource
|
|
mozilla::dom::WorkerPrivate* GetWorkerPrivate() const;
|
|
|
|
public:
|
|
// Initialize the ClientManager at process start. This
|
|
// does book-keeping like creating a TLS identifier, etc.
|
|
// This should only be called by process startup code.
|
|
static void Startup();
|
|
|
|
static UniquePtr<ClientSource> CreateSource(
|
|
ClientType aType, nsISerialEventTarget* aEventTarget,
|
|
nsIPrincipal* aPrincipal);
|
|
|
|
static UniquePtr<ClientSource> CreateSource(
|
|
ClientType aType, nsISerialEventTarget* aEventTarget,
|
|
const mozilla::ipc::PrincipalInfo& aPrincipal);
|
|
|
|
static already_AddRefed<ClientHandle> CreateHandle(
|
|
const ClientInfo& aClientInfo, nsISerialEventTarget* aSerialEventTarget);
|
|
|
|
static RefPtr<ClientOpPromise> MatchAll(const ClientMatchAllArgs& aArgs,
|
|
nsISerialEventTarget* aTarget);
|
|
|
|
static RefPtr<ClientOpPromise> Claim(
|
|
const ClientClaimArgs& aArgs, nsISerialEventTarget* aSerialEventTarget);
|
|
|
|
static RefPtr<ClientOpPromise> GetInfoAndState(
|
|
const ClientGetInfoAndStateArgs& aArgs,
|
|
nsISerialEventTarget* aSerialEventTarget);
|
|
|
|
static RefPtr<ClientOpPromise> Navigate(
|
|
const ClientNavigateArgs& aArgs,
|
|
nsISerialEventTarget* aSerialEventTarget);
|
|
|
|
static RefPtr<ClientOpPromise> OpenWindow(
|
|
const ClientOpenWindowArgs& aArgs,
|
|
nsISerialEventTarget* aSerialEventTarget);
|
|
|
|
NS_INLINE_DECL_REFCOUNTING(mozilla::dom::ClientManager)
|
|
};
|
|
|
|
} // namespace dom
|
|
} // namespace mozilla
|
|
|
|
#endif // _mozilla_dom_ClientManager_h
|