blob: 4f9f38747abc5ec7e572e68342701760e0515568 (
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
|
// Copyright 2015 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 COMPONENTS_ARC_ARC_SESSION_H_
#define COMPONENTS_ARC_ARC_SESSION_H_
#include <memory>
#include "base/macros.h"
#include "base/memory/ref_counted.h"
#include "base/observer_list.h"
#include "base/sequenced_task_runner.h"
#include "base/single_thread_task_runner.h"
#include "base/task_runner.h"
#include "components/arc/arc_bridge_service.h"
#include "components/arc/arc_stop_reason.h"
namespace arc {
// Starts the ARC instance and bootstraps the bridge connection.
// Clients should implement the Delegate to be notified upon communications
// being available.
// The instance can be safely removed 1) before Start() is called, or 2) after
// OnStopped() is called.
// The number of instances must be at most one. Otherwise, ARC instances will
// conflict.
class ArcSession {
public:
// Observer to notify events corresponding to one ARC session run.
class Observer {
public:
// Called when the connection with ARC instance has been established.
virtual void OnSessionReady() = 0;
// Called when ARC instance is stopped. This is called exactly once
// per instance which is Start()ed.
virtual void OnSessionStopped(ArcStopReason reason) = 0;
protected:
virtual ~Observer() = default;
};
// Creates a default instance of ArcSession.
static std::unique_ptr<ArcSession> Create(
ArcBridgeService* arc_bridge_service,
const scoped_refptr<base::TaskRunner>& blocking_task_runner);
virtual ~ArcSession();
// Starts and bootstraps a connection with the instance. The Observer's
// OnReady() will be called if the bootstrapping is successful, or
// OnStopped() if it is not. Start() should not be called twice or more.
virtual void Start() = 0;
// Requests to stop the currently-running instance.
// The completion is notified via OnStopped() of the Delegate.
virtual void Stop() = 0;
// Called when Chrome is in shutdown state. This is called when the message
// loop is already stopped, and the instance will soon be deleted.
virtual void OnShutdown() = 0;
void AddObserver(Observer* observer);
void RemoveObserver(Observer* observer);
protected:
ArcSession();
base::ObserverList<Observer> observer_list_;
private:
DISALLOW_COPY_AND_ASSIGN(ArcSession);
};
} // namespace arc
#endif // COMPONENTS_ARC_ARC_SESSION_H_
|
