Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(459)

Side by Side Diff: components/arc/arc_bridge_service.h

Issue 1534423002: Revert of arc-bridge: Move most methods to Mojo interfaces (Closed) Base URL: https://chromium.googlesource.com/a/chromium/src.git@master
Patch Set: Created 5 years ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « components/arc/BUILD.gn ('k') | components/arc/arc_bridge_service.cc » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 // Copyright 2015 The Chromium Authors. All rights reserved. 1 // Copyright 2015 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 #ifndef COMPONENTS_ARC_ARC_BRIDGE_SERVICE_H_ 5 #ifndef COMPONENTS_ARC_ARC_BRIDGE_SERVICE_H_
6 #define COMPONENTS_ARC_ARC_BRIDGE_SERVICE_H_ 6 #define COMPONENTS_ARC_ARC_BRIDGE_SERVICE_H_
7 7
8 #include <string> 8 #include <string>
9 #include <vector> 9 #include <vector>
10 10
11 #include "base/files/scoped_file.h" 11 #include "base/files/scoped_file.h"
12 #include "base/gtest_prod_util.h" 12 #include "base/gtest_prod_util.h"
13 #include "base/macros.h" 13 #include "base/macros.h"
14 #include "base/memory/scoped_ptr.h" 14 #include "base/memory/scoped_ptr.h"
15 #include "base/observer_list.h" 15 #include "base/observer_list.h"
16 #include "base/values.h" 16 #include "base/values.h"
17 #include "components/arc/common/arc_bridge.mojom.h" 17 #include "components/arc/common/arc_bridge.mojom.h"
18 18
19 namespace base { 19 namespace base {
20 class CommandLine; 20 class CommandLine;
21 } // namespace base 21 } // namespace base
22 22
23 namespace arc { 23 namespace arc {
24 24
25 class ArcBridgeBootstrap; 25 class ArcBridgeBootstrap;
26 26
27 // The Chrome-side service that handles ARC instances and ARC bridge creation. 27 // The Chrome-side service that handles ARC instances and ARC bridge creation.
28 // This service handles the lifetime of ARC instances and sets up the 28 // This service handles the lifetime of ARC instances and sets up the
29 // communication channel (the ARC bridge) used to send and receive messages. 29 // communication channel (the ARC bridge) used to send and receive messages.
30 class ArcBridgeService : public ArcBridgeHost { 30 class ArcBridgeService {
31 public: 31 public:
32 // The possible states of the bridge. In the normal flow, the state changes 32 // The possible states of the bridge. In the normal flow, the state changes
33 // in the following sequence: 33 // in the following sequence:
34 // 34 //
35 // STOPPED 35 // STOPPED
36 // PrerequisitesChanged() -> 36 // PrerequisitesChanged() ->
37 // CONNECTING 37 // CONNECTING
38 // OnConnectionEstablished() -> 38 // OnConnectionEstablished() ->
39 // CONNECTED
40 // OnInstanceBootPhase(INSTANCE_BOOT_PHASE_BRIDGE_READY) ->
39 // READY 41 // READY
40 // 42 //
41 // The ArcBridgeBootstrap state machine can be thought of being substates of 43 // The ArcBridgeBootstrap state machine can be thought of being substates of
42 // ArcBridgeService's CONNECTING state. 44 // ArcBridgeService's CONNECTING state.
43 // 45 //
44 // * 46 // *
45 // StopInstance() -> 47 // StopInstance() ->
46 // STOPPING 48 // STOPPING
47 // OnStopped() -> 49 // OnStopped() ->
48 // STOPPED 50 // STOPPED
(...skipping 14 matching lines...) Expand all
63 // The ARC instance has started shutting down. 65 // The ARC instance has started shutting down.
64 STOPPING, 66 STOPPING,
65 }; 67 };
66 68
67 // Notifies life cycle events of ArcBridgeService. 69 // Notifies life cycle events of ArcBridgeService.
68 class Observer { 70 class Observer {
69 public: 71 public:
70 // Called whenever the state of the bridge has changed. 72 // Called whenever the state of the bridge has changed.
71 virtual void OnStateChanged(State state) {} 73 virtual void OnStateChanged(State state) {}
72 74
75 // Called when the instance has reached a boot phase
76 virtual void OnInstanceBootPhase(InstanceBootPhase phase) {}
77
73 // Called whenever ARC's availability has changed for this system. 78 // Called whenever ARC's availability has changed for this system.
74 virtual void OnAvailableChanged(bool available) {} 79 virtual void OnAvailableChanged(bool available) {}
75 80
76 // Called whenever the ARC app list is ready.
77 virtual void OnAppInstanceReady() {}
78
79 // Called whenever the ARC input is ready.
80 virtual void OnInputInstanceReady() {}
81
82 // Called whenever the ARC notification is ready.
83 virtual void OnNotificationsInstanceReady() {}
84
85 // Called whenever the ARC power is ready.
86 virtual void OnPowerInstanceReady() {}
87
88 // Called whenever the ARC process is ready.
89 virtual void OnProcessInstanceReady() {}
90
91 // Called whenever the ARC settings is ready.
92 virtual void OnSettingsInstanceReady() {}
93
94 protected: 81 protected:
95 virtual ~Observer() {} 82 virtual ~Observer() {}
96 }; 83 };
97 84
98 ~ArcBridgeService() override; 85 class NotificationObserver {
86 public:
87 // Called whenever a notification has been posted on Android side. This
88 // event is used for both creation and update.
89 virtual void OnNotificationPostedFromAndroid(
90 const ArcNotificationData& data) {}
91 // Called whenever a notification has been removed on Android side.
92 virtual void OnNotificationRemovedFromAndroid(const std::string& key) {}
93
94 protected:
95 virtual ~NotificationObserver() {}
96 };
97
98 // Notifies ARC apps related events.
99 class AppObserver {
100 public:
101 // Called whenever ARC sends information about available apps.
102 virtual void OnAppListRefreshed(const std::vector<AppInfo>& apps) {}
103
104 // Called whenever ARC sends app icon data for specific scale factor.
105 virtual void OnAppIcon(const std::string& package,
106 const std::string& activity,
107 ScaleFactor scale_factor,
108 const std::vector<uint8_t>& icon_png_data) {}
109
110 protected:
111 virtual ~AppObserver() {}
112 };
113
114 // Notifies ARC process related events.
115 class ProcessObserver {
116 public:
117 // Called when the latest process list has been received after
118 // ArcBridgeService::RequestProcessList() was called.
119 //
120 // NB: Due to the nature of Linux PID, we can not avoid the race condition
121 // that the process info is already outdated when the message is received.
122 // Do not use the process list obtained here for security-sensitive purpose.
123 // Good news is that Android processes are designed to be ready to be killed
124 // at any time, so killing a wrong process is not a disaster.
125 virtual void OnUpdateProcessList(
126 const std::vector<RunningAppProcessInfo>& processes) {}
127
128 protected:
129 virtual ~ProcessObserver() {}
130 };
131
132 virtual ~ArcBridgeService();
99 133
100 // Gets the global instance of the ARC Bridge Service. This can only be 134 // Gets the global instance of the ARC Bridge Service. This can only be
101 // called on the thread that this class was created on. 135 // called on the thread that this class was created on.
102 static ArcBridgeService* Get(); 136 static ArcBridgeService* Get();
103 137
104 // Return true if ARC has been enabled through a commandline 138 // Return true if ARC has been enabled through a commandline
105 // switch. 139 // switch.
106 static bool GetEnabled(const base::CommandLine* command_line); 140 static bool GetEnabled(const base::CommandLine* command_line);
107 141
108 // DetectAvailability() should be called once D-Bus is available. It will 142 // DetectAvailability() should be called once D-Bus is available. It will
109 // call CheckArcAvailability() on the session_manager. This can only be 143 // call CheckArcAvailability() on the session_manager. This can only be
110 // called on the thread that this class was created on. 144 // called on the thread that this class was created on.
111 virtual void DetectAvailability() = 0; 145 virtual void DetectAvailability() = 0;
112 146
113 // HandleStartup() should be called upon profile startup. This will only 147 // HandleStartup() should be called upon profile startup. This will only
114 // launch an instance if the instance service is available and it is enabled. 148 // launch an instance if the instance service is available and it is enabled.
115 // This can only be called on the thread that this class was created on. 149 // This can only be called on the thread that this class was created on.
116 virtual void HandleStartup() = 0; 150 virtual void HandleStartup() = 0;
117 151
118 // Shutdown() should be called when the browser is shutting down. This can 152 // Shutdown() should be called when the browser is shutting down. This can
119 // only be called on the thread that this class was created on. 153 // only be called on the thread that this class was created on.
120 virtual void Shutdown() = 0; 154 virtual void Shutdown() = 0;
121 155
122 // Adds or removes observers. This can only be called on the thread that this 156 // Adds or removes observers. This can only be called on the thread that this
123 // class was created on. 157 // class was created on.
124 void AddObserver(Observer* observer); 158 void AddObserver(Observer* observer);
125 void RemoveObserver(Observer* observer); 159 void RemoveObserver(Observer* observer);
160 void AddNotificationObserver(NotificationObserver* observer);
161 void RemoveNotificationObserver(NotificationObserver* observer);
126 162
127 // Gets the Mojo interface for all the instance services. This will return 163 // Adds or removes ARC app observers. This can only be called on the thread
128 // nullptr if that particular service is not ready yet. Use an Observer if 164 // that this class was created on.
129 // you want to be notified when this is ready. This can only be called on the 165 void AddAppObserver(AppObserver* observer);
166 void RemoveAppObserver(AppObserver* observer);
167
168 // Adds or removes ARC process observers. This can only be called on the
130 // thread that this class was created on. 169 // thread that this class was created on.
131 AppInstance* app_instance() { return app_ptr_.get(); } 170 void AddProcessObserver(ProcessObserver* observer);
132 InputInstance* input_instance() { return input_ptr_.get(); } 171 void RemoveProcessObserver(ProcessObserver* observer);
133 NotificationsInstance* notifications_instance() {
134 return notifications_ptr_.get();
135 }
136 PowerInstance* power_instance() { return power_ptr_.get(); }
137 ProcessInstance* process_instance() { return process_ptr_.get(); }
138 SettingsInstance* settings_instance() { return settings_ptr_.get(); }
139
140 // ArcHost:
141 void OnAppInstanceReady(AppInstancePtr app_ptr) override;
142 void OnInputInstanceReady(InputInstancePtr input_ptr) override;
143 void OnNotificationsInstanceReady(
144 NotificationsInstancePtr notifications_ptr) override;
145 void OnPowerInstanceReady(PowerInstancePtr power_ptr) override;
146 void OnProcessInstanceReady(ProcessInstancePtr process_ptr) override;
147 void OnSettingsInstanceReady(SettingsInstancePtr process_ptr) override;
148 172
149 // Gets the current state of the bridge service. 173 // Gets the current state of the bridge service.
150 State state() const { return state_; } 174 State state() const { return state_; }
151 175
152 // Gets if ARC is available in this system. 176 // Gets if ARC is available in this system.
153 bool available() const { return available_; } 177 bool available() const { return available_; }
154 178
179 // Requests registration of an input device on the ARC instance.
180 // TODO(denniskempin): Make this interface more typesafe.
181 // |name| should be the displayable name of the emulated device (e.g. "Chrome
182 // OS Keyboard"), |device_type| the name of the device type (e.g. "keyboard")
183 // and |fd| a file descriptor that emulates the kernel events of the device.
184 // This can only be called on the thread that this class was created on.
185 virtual bool RegisterInputDevice(const std::string& name,
186 const std::string& device_type,
187 base::ScopedFD fd) = 0;
188
189 // Sends a notification event to Android side.
190 virtual bool SendNotificationEventToAndroid(const std::string& key,
191 ArcNotificationEvent event) = 0;
192
193 // Requests to refresh an app list.
194 virtual bool RefreshAppList() = 0;
195
196 // Requests to launch an app.
197 virtual bool LaunchApp(const std::string& package,
198 const std::string& activity) = 0;
199
200 // Requests to load an icon of specific scale_factor.
201 virtual bool RequestAppIcon(const std::string& package,
202 const std::string& activity,
203 ScaleFactor scale_factor) = 0;
204
205 // Requests a list of processes from the ARC instance.
206 // When the result comes back, Observer::OnUpdateProcessList() is called.
207 virtual bool RequestProcessList() = 0;
208
209 // Send an Android broadcast message to the Android package and class
210 // specified. The 'extras' DictionaryValue will be converted to an Android
211 // Bundle accessible by the broadcast receiver.
212 //
213 // Note: Broadcasts can only be sent to whitelisted packages. Packages can be
214 // added to the whitelist in ArcBridgeService.java in the Android source.
215 virtual bool SendBroadcast(const std::string& action,
216 const std::string& package,
217 const std::string& clazz,
218 const base::DictionaryValue& extras) = 0;
219
155 protected: 220 protected:
156 ArcBridgeService(); 221 ArcBridgeService();
157 222
158 // Changes the current state and notifies all observers. 223 // Changes the current state and notifies all observers.
159 void SetState(State state); 224 void SetState(State state);
160 225
161 // Changes the current availability and notifies all observers. 226 // Changes the current availability and notifies all observers.
162 void SetAvailable(bool availability); 227 void SetAvailable(bool availability);
163 228
164 base::ObserverList<Observer>& observer_list() { return observer_list_; } 229 base::ObserverList<Observer>& observer_list() { return observer_list_; }
165 230
231 base::ObserverList<NotificationObserver>& notification_observer_list() {
232 return notification_observer_list_;
233 }
234
235 base::ObserverList<AppObserver>& app_observer_list() {
236 return app_observer_list_;
237 }
238
239 base::ObserverList<ProcessObserver>& process_observer_list() {
240 return process_observer_list_;
241 }
242
166 bool CalledOnValidThread(); 243 bool CalledOnValidThread();
167 244
168 private: 245 private:
169 friend class ArcBridgeTest; 246 friend class ArcBridgeTest;
170 FRIEND_TEST_ALL_PREFIXES(ArcBridgeTest, Basic); 247 FRIEND_TEST_ALL_PREFIXES(ArcBridgeTest, Basic);
171 FRIEND_TEST_ALL_PREFIXES(ArcBridgeTest, Prerequisites); 248 FRIEND_TEST_ALL_PREFIXES(ArcBridgeTest, Prerequisites);
172 FRIEND_TEST_ALL_PREFIXES(ArcBridgeTest, ShutdownMidStartup); 249 FRIEND_TEST_ALL_PREFIXES(ArcBridgeTest, ShutdownMidStartup);
173 250
174 // Mojo interfaces.
175 AppInstancePtr app_ptr_;
176 InputInstancePtr input_ptr_;
177 NotificationsInstancePtr notifications_ptr_;
178 PowerInstancePtr power_ptr_;
179 ProcessInstancePtr process_ptr_;
180 SettingsInstancePtr settings_ptr_;
181
182 base::ObserverList<Observer> observer_list_; 251 base::ObserverList<Observer> observer_list_;
252 base::ObserverList<NotificationObserver> notification_observer_list_;
253 base::ObserverList<AppObserver> app_observer_list_;
254 base::ObserverList<ProcessObserver> process_observer_list_;
183 255
184 base::ThreadChecker thread_checker_; 256 base::ThreadChecker thread_checker_;
185 257
186 // If the ARC instance service is available. 258 // If the ARC instance service is available.
187 bool available_; 259 bool available_;
188 260
189 // The current state of the bridge. 261 // The current state of the bridge.
190 ArcBridgeService::State state_; 262 ArcBridgeService::State state_;
191 263
192 DISALLOW_COPY_AND_ASSIGN(ArcBridgeService); 264 DISALLOW_COPY_AND_ASSIGN(ArcBridgeService);
193 }; 265 };
194 266
195 } // namespace arc 267 } // namespace arc
196 268
197 #endif // COMPONENTS_ARC_ARC_BRIDGE_SERVICE_H_ 269 #endif // COMPONENTS_ARC_ARC_BRIDGE_SERVICE_H_
OLDNEW
« no previous file with comments | « components/arc/BUILD.gn ('k') | components/arc/arc_bridge_service.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698