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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
// 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.
// SyncSessionContext encapsulates the contextual information and engine
// components specific to a SyncSession. A context is accessible via
// a SyncSession so that session SyncerCommands and parts of the engine have
// a convenient way to access other parts. In this way it can be thought of as
// the surrounding environment for the SyncSession. The components of this
// environment are either valid or not valid for the entire context lifetime,
// or they are valid for explicitly scoped periods of time by using Scoped
// installation utilities found below. This means that the context assumes no
// ownership whatsoever of any object that was not created by the context
// itself.
//
// It can only be used from the SyncerThread.
#ifndef SYNC_SESSIONS_SYNC_SESSION_CONTEXT_H_
#define SYNC_SESSIONS_SYNC_SESSION_CONTEXT_H_
#include <map>
#include <string>
#include <vector>
#include "sync/engine/sync_engine_event.h"
#include "sync/engine/syncer_types.h"
#include "sync/engine/traffic_recorder.h"
#include "sync/internal_api/public/engine/model_safe_worker.h"
#include "sync/sessions/debug_info_getter.h"
namespace syncer {
class ConflictResolver;
class ExtensionsActivityMonitor;
class ServerConnectionManager;
class ThrottledDataTypeTracker;
namespace syncable {
class Directory;
}
// Default number of items a client can commit in a single message.
static const int kDefaultMaxCommitBatchSize = 25;
namespace sessions {
class ScopedSessionContextConflictResolver;
class TestScopedSessionEventListener;
class SyncSessionContext {
public:
SyncSessionContext(ServerConnectionManager* connection_manager,
syncable::Directory* directory,
const std::vector<ModelSafeWorker*>& workers,
ExtensionsActivityMonitor* extensions_activity_monitor,
ThrottledDataTypeTracker* throttled_data_type_tracker,
const std::vector<SyncEngineEventListener*>& listeners,
DebugInfoGetter* debug_info_getter,
TrafficRecorder* traffic_recorder,
bool keystore_encryption_enabled);
~SyncSessionContext();
ConflictResolver* resolver() { return resolver_; }
ServerConnectionManager* connection_manager() {
return connection_manager_;
}
syncable::Directory* directory() {
return directory_;
}
const ModelSafeRoutingInfo& routing_info() const {
return routing_info_;
}
void set_routing_info(const ModelSafeRoutingInfo& routing_info) {
routing_info_ = routing_info;
}
const std::vector<ModelSafeWorker*> workers() const {
return workers_;
}
ExtensionsActivityMonitor* extensions_monitor() {
return extensions_activity_monitor_;
}
ThrottledDataTypeTracker* throttled_data_type_tracker() {
return throttled_data_type_tracker_;
}
DebugInfoGetter* debug_info_getter() {
return debug_info_getter_;
}
// Talk notification status.
void set_notifications_enabled(bool enabled) {
notifications_enabled_ = enabled;
}
bool notifications_enabled() { return notifications_enabled_; }
// Account name, set once a directory has been opened.
void set_account_name(const std::string& name) {
DCHECK(account_name_.empty());
account_name_ = name;
}
const std::string& account_name() const { return account_name_; }
void set_max_commit_batch_size(int batch_size) {
max_commit_batch_size_ = batch_size;
}
int32 max_commit_batch_size() const { return max_commit_batch_size_; }
void NotifyListeners(const SyncEngineEvent& event) {
FOR_EACH_OBSERVER(SyncEngineEventListener, listeners_,
OnSyncEngineEvent(event));
}
TrafficRecorder* traffic_recorder() {
return traffic_recorder_;
}
bool keystore_encryption_enabled() const {
return keystore_encryption_enabled_;
}
private:
// Rather than force clients to set and null-out various context members, we
// extend our encapsulation boundary to scoped helpers that take care of this
// once they are allocated. See definitions of these below.
friend class ScopedSessionContextConflictResolver;
friend class TestScopedSessionEventListener;
// This is installed by Syncer objects when needed and may be NULL.
ConflictResolver* resolver_;
ObserverList<SyncEngineEventListener> listeners_;
ServerConnectionManager* const connection_manager_;
syncable::Directory* const directory_;
// A cached copy of SyncBackendRegistrar's routing info.
// Must be updated manually when SBR's state is modified.
ModelSafeRoutingInfo routing_info_;
// The set of ModelSafeWorkers. Used to execute tasks of various threads.
const std::vector<ModelSafeWorker*> workers_;
// We use this to stuff extensions activity into CommitMessages so the server
// can correlate commit traffic with extension-related bookmark mutations.
ExtensionsActivityMonitor* extensions_activity_monitor_;
// Kept up to date with talk events to determine whether notifications are
// enabled. True only if the notification channel is authorized and open.
bool notifications_enabled_;
// The name of the account being synced.
std::string account_name_;
// The server limits the number of items a client can commit in one batch.
int max_commit_batch_size_;
ThrottledDataTypeTracker* throttled_data_type_tracker_;
// We use this to get debug info to send to the server for debugging
// client behavior on server side.
DebugInfoGetter* const debug_info_getter_;
TrafficRecorder* traffic_recorder_;
// Temporary variable while keystore encryption is behind a flag. True if
// we should attempt performing keystore encryption related work, false if
// the experiment is not enabled.
bool keystore_encryption_enabled_;
DISALLOW_COPY_AND_ASSIGN(SyncSessionContext);
};
// Installs a ConflictResolver to a given session context for the lifetime of
// the ScopedSessionContextConflictResolver. There should never be more than
// one ConflictResolver in the system, so it is an error to use this if the
// context already has a resolver.
class ScopedSessionContextConflictResolver {
public:
// Note: |context| and |resolver| should outlive |this|.
ScopedSessionContextConflictResolver(SyncSessionContext* context,
ConflictResolver* resolver)
: context_(context), resolver_(resolver) {
DCHECK(NULL == context->resolver_);
context->resolver_ = resolver;
}
~ScopedSessionContextConflictResolver() {
context_->resolver_ = NULL;
}
private:
SyncSessionContext* context_;
ConflictResolver* resolver_;
DISALLOW_COPY_AND_ASSIGN(ScopedSessionContextConflictResolver);
};
} // namespace sessions
} // namespace syncer
#endif // SYNC_SESSIONS_SYNC_SESSION_CONTEXT_H_
|