blob: b6f2a3850b9ff27982678e108441a17e8b6ca5f4 [file] [log] [blame]
// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include <memory>
#include "base/callback_forward.h"
#include "base/sequenced_task_runner.h"
#include "services/service_manager/public/cpp/identity.h"
#include "services/service_manager/public/mojom/service.mojom.h"
namespace service_manager {
class Connector;
namespace web {
// Encapsulates a connection to a //services/service_manager.
// Access a global instance on the thread the ServiceContext was bound by
// calling Holder::Get().
// Clients can add service_manager::Service implementations whose exposed
// interfaces
// will be exposed to inbound connections to this object's Service.
// Alternatively clients can define named services that will be constructed when
// requests for those service names are received.
// Clients must call any of the registration methods when receiving
// WebClient::RegisterInProcessServices().
class ServiceManagerConnection {
// Sets |connection| as the connection that is globally accessible from the
// UI thread. Should be called on the UI thread.
static void Set(std::unique_ptr<ServiceManagerConnection> connection);
// Returns the global instance, or nullptr if the Service Manager
// connection has not yet been bound. Should be called on the UI thread.
static ServiceManagerConnection* Get();
// Destroys the global instance. Should be called on the UI thread.
static void Destroy();
virtual ~ServiceManagerConnection();
// Creates a ServiceManagerConnection from |request|. The connection binds
// its interfaces and accept new connections on |io_task_runner| only. Note
// that no incoming connections are accepted until Start() is called.
static std::unique_ptr<ServiceManagerConnection> Create(
service_manager::mojom::ServiceRequest request,
scoped_refptr<base::SequencedTaskRunner> io_task_runner);
// Begins accepting incoming connections.
virtual void Start() = 0;
// Returns the service_manager::Connector received via this connection's
// Service implementation. Use this to initiate connections as this object's
// Identity.
virtual service_manager::Connector* GetConnector() = 0;
// Sets a callback to be invoked on the ServiceManagerConnection's owning
// sequence with any unhandled service requests.
using ServiceRequestHandler = base::RepeatingCallback<void(
const std::string& service_name,
service_manager::mojom::ServiceRequest request)>;
virtual void SetDefaultServiceRequestHandler(
const ServiceRequestHandler& handler) = 0;
} // namespace web