blob: e521fbd4c5e1c46c6a25a866008932933593b7f5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
// Copyright (c) 2012 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.
#ifndef CONTENT_PUBLIC_UTILITY_CONTENT_UTILITY_CLIENT_H_
#define CONTENT_PUBLIC_UTILITY_CONTENT_UTILITY_CLIENT_H_
#include <map>
#include <memory>
#include "base/callback_forward.h"
#include "content/public/common/content_client.h"
#include "mojo/public/cpp/bindings/generic_pending_receiver.h"
#include "services/service_manager/public/cpp/binder_map.h"
#include "services/service_manager/public/cpp/binder_registry.h"
#include "services/service_manager/public/cpp/service.h"
#include "services/service_manager/public/mojom/service.mojom.h"
namespace IPC {
class Message;
}
namespace mojo {
class BinderMap;
class ServiceFactory;
}
namespace content {
// Embedder API for participating in utility process logic.
class CONTENT_EXPORT ContentUtilityClient {
public:
virtual ~ContentUtilityClient() {}
// Notifies us that the UtilityThread has been created.
virtual void UtilityThreadStarted() {}
// Allows the embedder to filter messages.
virtual bool OnMessageReceived(const IPC::Message& message);
// Allows the embedder to register interface binders to handle interface
// requests coming in from the browser process. These are requests that the
// browser issues through the ChildProcessHost's BindReceiver() API on the
// corresponding UtilityProcessHost.
virtual void ExposeInterfacesToBrowser(mojo::BinderMap* binders) {}
// Allows the embedder to handle an incoming service request. If this is
// called, this utility process was started for the sole purpose of running
// the service identified by |service_name|.
//
// The embedder should return |true| to indicate that |request| has been
// handled by running the expected service. It is the embedder's
// responsibility to ensure that this utility process exits (see
// |UtilityThread::ReleaseProcess()|) once the running service terminates.
//
// If the embedder returns |false| this process is terminated immediately.
virtual bool HandleServiceRequest(
const std::string& service_name,
service_manager::mojom::ServiceRequest request);
// Allows the embedder to handle an incoming service interface request to run
// a service on the IO thread. Should return a ServiceFactory instance which
// lives at least as long as the IO thread, or nullptr.
//
// Only called from the IO thread.
virtual mojo::ServiceFactory* GetIOThreadServiceFactory();
// Allows the embedder to handle an incoming service interface request to run
// a service on the main thread. Should return a ServiceFactory instance which
// which effectively lives forever, or nullptr.
//
// Only called from the main thread.
virtual mojo::ServiceFactory* GetMainThreadServiceFactory();
virtual void RegisterNetworkBinders(
service_manager::BinderRegistry* registry) {}
};
} // namespace content
#endif // CONTENT_PUBLIC_UTILITY_CONTENT_UTILITY_CLIENT_H_
|
