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
|
// Copyright 2013 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_MANAGED_MODE_MANAGED_USER_SYNC_SERVICE_H_
#define CHROME_BROWSER_MANAGED_MODE_MANAGED_USER_SYNC_SERVICE_H_
#include <vector>
#include "base/callback_forward.h"
#include "base/memory/scoped_ptr.h"
#include "base/observer_list.h"
#include "base/prefs/pref_change_registrar.h"
#include "chrome/browser/managed_mode/managed_user_sync_service_observer.h"
#include "chrome/browser/managed_mode/managed_users.h"
#include "components/browser_context_keyed_service/browser_context_keyed_service.h"
#include "sync/api/syncable_service.h"
namespace base {
class DictionaryValue;
}
namespace user_prefs {
class PrefRegistrySyncable;
}
class PrefService;
class ManagedUserSyncService : public BrowserContextKeyedService,
public syncer::SyncableService {
public:
// For use with GetManagedUsersAsync() below.
typedef base::Callback<void(const base::DictionaryValue*)>
ManagedUsersCallback;
// Dictionary keys for entry values of |prefs::kManagedUsers|.
static const char kAcknowledged[];
static const char kChromeAvatar[];
static const char kChromeOsAvatar[];
static const char kMasterKey[];
static const char kName[];
// Represents a non-existing avatar on Chrome and Chrome OS.
static const int kNoAvatar;
virtual ~ManagedUserSyncService();
static void RegisterProfilePrefs(user_prefs::PrefRegistrySyncable* registry);
// Extracts the avatar index from the input |avatar_str| and set
// |avatar_index| to hold the extracted value. Returns true if the
// index was extracted successfully and false otherwise.
// |avatar_str| should have the format: "chrome-avatar-index:INDEX"
// where INDEX is the integer to be extracted. |avatar_str| can be empty
// in case there is no avatar synced for a managed user in which case
// |avatar_index| is set to -1.
static bool GetAvatarIndex(const std::string& avatar_str,
int* avatar_index);
// Given an |avatar_index|, it returns a string of the form:
// "chrome-avatar-index:INDEX" where INDEX = |avatar_index|.
// It is exposed for testing purposes only.
static std::string BuildAvatarString(int avatar_index);
void AddObserver(ManagedUserSyncServiceObserver* observer);
void RemoveObserver(ManagedUserSyncServiceObserver* observer);
void AddManagedUser(const std::string& id,
const std::string& name,
const std::string& master_key,
int avatar_index);
void DeleteManagedUser(const std::string& id);
// Updates the managed user avatar only if the managed user has
// no avatar and |avatar_index| is set to some value other than
// |kNoAvatar|. If |avatar_index| equals |kNoAvatar| and the
// managed user has an avatar, it will be cleared. However,
// to clear an avatar call the convenience method |ClearManagedUserAvatar()|.
// Returns true if the avatar value is changed (either updated or cleared)
// and false otherwise.
bool UpdateManagedUserAvatarIfNeeded(const std::string& id, int avatar_index);
void ClearManagedUserAvatar(const std::string& id);
// Returns a dictionary containing all managed users managed by this
// custodian. This method should only be called once this service has started
// syncing managed users (i.e. has finished its initial merge of local and
// server-side data, via MergeDataAndStartSyncing), as the stored data might
// be outdated before that.
const base::DictionaryValue* GetManagedUsers();
// Calls the passed |callback| with a dictionary containing all managed users
// managed by this custodian.
void GetManagedUsersAsync(const ManagedUsersCallback& callback);
// BrowserContextKeyedService implementation:
virtual void Shutdown() OVERRIDE;
// SyncableService implementation:
virtual syncer::SyncMergeResult MergeDataAndStartSyncing(
syncer::ModelType type,
const syncer::SyncDataList& initial_sync_data,
scoped_ptr<syncer::SyncChangeProcessor> sync_processor,
scoped_ptr<syncer::SyncErrorFactory> error_handler) OVERRIDE;
virtual void StopSyncing(syncer::ModelType type) OVERRIDE;
virtual syncer::SyncDataList GetAllSyncData(syncer::ModelType type) const
OVERRIDE;
virtual syncer::SyncError ProcessSyncChanges(
const tracked_objects::Location& from_here,
const syncer::SyncChangeList& change_list) OVERRIDE;
private:
friend class ManagedUserSyncServiceFactory;
// Use |ManagedUserSyncServiceFactory::GetForProfile(...)| to get an
// instance of this service.
explicit ManagedUserSyncService(PrefService* prefs);
void OnLastSignedInUsernameChange();
void NotifyManagedUserAcknowledged(const std::string& managed_user_id);
void NotifyManagedUsersSyncingStopped();
void DispatchCallbacks();
PrefService* prefs_;
PrefChangeRegistrar pref_change_registrar_;
scoped_ptr<syncer::SyncChangeProcessor> sync_processor_;
scoped_ptr<syncer::SyncErrorFactory> error_handler_;
ObserverList<ManagedUserSyncServiceObserver> observers_;
std::vector<ManagedUsersCallback> callbacks_;
DISALLOW_COPY_AND_ASSIGN(ManagedUserSyncService);
};
#endif // CHROME_BROWSER_MANAGED_MODE_MANAGED_USER_SYNC_SERVICE_H_
|