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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
// 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 CHROME_BROWSER_POLICY_CLOUD_REMOTE_COMMANDS_INVALIDATOR_H_
#define CHROME_BROWSER_POLICY_CLOUD_REMOTE_COMMANDS_INVALIDATOR_H_
#include "base/macros.h"
#include "base/threading/thread_checker.h"
#include "components/invalidation/public/invalidation_handler.h"
#include "components/policy/proto/device_management_backend.pb.h"
#include "google/cacheinvalidation/include/types.h"
namespace invalidation {
class InvalidationService;
} // namespace invalidation
namespace policy {
// This class provides basic intefaces for an invalidator for remote commands
// services. It's not interacting with CloudPolicyClient/CloudPolicyCore
// directly, instead, it handles the interacting with invalidation service
// only and leaves interfaces to integrate with subclasses.
class RemoteCommandsInvalidator : public syncer::InvalidationHandler {
public:
RemoteCommandsInvalidator();
~RemoteCommandsInvalidator() override;
// Initialize this invalidator to pair with |invalidation_service|. Must be
// called before Start().
void Initialize(invalidation::InvalidationService* invalidation_service);
// Shutdown this invalidator. Will stop the invalidator first, and after
// shutting down, the invalidator can't be started anymore unless it's
// initialized again.
void Shutdown();
// Starts to process invalidations.
void Start();
// Stops to process invalidation. May only be called after Start() has been
// called.
void Stop();
// Helpful accessors.
invalidation::InvalidationService* invalidation_service() {
return invalidation_service_;
}
bool invalidations_enabled() { return invalidations_enabled_; }
// syncer::InvalidationHandler:
void OnInvalidatorStateChange(syncer::InvalidatorState state) override;
void OnIncomingInvalidation(
const syncer::ObjectIdInvalidationMap& invalidation_map) override;
std::string GetOwnerName() const override;
protected:
virtual void OnInitialize() = 0;
virtual void OnShutdown() = 0;
virtual void OnStart() = 0;
virtual void OnStop() = 0;
// Subclasses must override this method to implement the actual remote
// commands fetch.
virtual void DoRemoteCommandsFetch() = 0;
// Subclasses must call this function to set the object id for remote command
// invalidations.
void ReloadPolicyData(const enterprise_management::PolicyData* policy);
private:
// Registers the given object with the invalidation service.
void Register(const invalidation::ObjectId& object_id);
// Unregisters the current object with the invalidation service.
void Unregister();
// Updates invalidations_enabled_.
void UpdateInvalidationsEnabled();
// The state of the object.
enum State {
SHUT_DOWN,
STOPPED,
STARTED,
};
State state_ = SHUT_DOWN;
// The invalidation service.
invalidation::InvalidationService* invalidation_service_ = nullptr;
// Whether the invalidator currently has the ability to receive invalidations.
// This is true if the invalidation service is enabled and the invalidator
// has registered for a remote commands object.
bool invalidations_enabled_ = false;
// Whether the invalidation service is currently enabled.
bool invalidation_service_enabled_ = false;
// Whether this object has registered for remote commands invalidations.
bool is_registered_ = false;
// The object id representing the remote commands in the invalidation service.
invalidation::ObjectId object_id_;
// A thread checker to make sure that callbacks are invoked on the correct
// thread.
base::ThreadChecker thread_checker_;
DISALLOW_COPY_AND_ASSIGN(RemoteCommandsInvalidator);
};
} // namespace policy
#endif // CHROME_BROWSER_POLICY_CLOUD_REMOTE_COMMANDS_INVALIDATOR_H_
|
