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
|
// 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.
#ifndef COMPONENTS_SYNC_DRIVER_SYNC_PREFS_H_
#define COMPONENTS_SYNC_DRIVER_SYNC_PREFS_H_
#include "base/basictypes.h"
#include "base/compiler_specific.h"
#include "base/memory/weak_ptr.h"
#include "base/observer_list.h"
#include "base/prefs/pref_member.h"
#include "base/threading/non_thread_safe.h"
#include "base/time/time.h"
#include "sync/internal_api/public/base/model_type.h"
class PrefService;
class ProfileIOData;
namespace user_prefs {
class PrefRegistrySyncable;
}
namespace sync_driver {
class SyncPrefObserver {
public:
// Called whenever the pref that controls whether sync is managed
// changes.
virtual void OnSyncManagedPrefChange(bool is_sync_managed) = 0;
protected:
virtual ~SyncPrefObserver();
};
// SyncPrefs is a helper class that manages getting, setting, and
// persisting global sync preferences. It is not thread-safe, and
// lives on the UI thread.
//
// TODO(akalin): Some classes still read the prefs directly. Consider
// passing down a pointer to SyncPrefs to them. A list of files:
//
// profile_sync_service_startup_unittest.cc
// profile_sync_service.cc
// sync_setup_flow.cc
// sync_setup_wizard.cc
// sync_setup_wizard_unittest.cc
// two_client_preferences_sync_test.cc
class SyncPrefs : NON_EXPORTED_BASE(public base::NonThreadSafe),
public base::SupportsWeakPtr<SyncPrefs> {
public:
// |pref_service| may not be NULL.
// Does not take ownership of |pref_service|.
explicit SyncPrefs(PrefService* pref_service);
// For testing.
SyncPrefs();
virtual ~SyncPrefs();
static void RegisterProfilePrefs(user_prefs::PrefRegistrySyncable* registry);
void AddSyncPrefObserver(SyncPrefObserver* sync_pref_observer);
void RemoveSyncPrefObserver(SyncPrefObserver* sync_pref_observer);
// Clears important sync preferences.
void ClearPreferences();
// Getters and setters for global sync prefs.
bool HasSyncSetupCompleted() const;
void SetSyncSetupCompleted();
bool SyncHasAuthError() const;
void SetSyncAuthError(bool error);
bool IsStartSuppressed() const;
void SetStartSuppressed(bool is_suppressed);
base::Time GetLastSyncedTime() const;
void SetLastSyncedTime(base::Time time);
bool HasKeepEverythingSynced() const;
void SetKeepEverythingSynced(bool keep_everything_synced);
// The returned set is guaranteed to be a subset of
// |registered_types|. Returns |registered_types| directly if
// HasKeepEverythingSynced() is true.
syncer::ModelTypeSet GetPreferredDataTypes(
syncer::ModelTypeSet registered_types) const;
// |preferred_types| should be a subset of |registered_types|. All
// types in |preferred_types| are marked preferred, and all types in
// |registered_types| \ |preferred_types| are marked not preferred.
// Changes are still made to the prefs even if
// HasKeepEverythingSynced() is true, but won't be visible until
// SetKeepEverythingSynced(false) is called.
void SetPreferredDataTypes(syncer::ModelTypeSet registered_types,
syncer::ModelTypeSet preferred_types);
// This pref is set outside of sync.
bool IsManaged() const;
// Use this encryption bootstrap token if we're using an explicit passphrase.
std::string GetEncryptionBootstrapToken() const;
void SetEncryptionBootstrapToken(const std::string& token);
// Use this keystore bootstrap token if we're not using an explicit
// passphrase.
std::string GetKeystoreEncryptionBootstrapToken() const;
void SetKeystoreEncryptionBootstrapToken(const std::string& token);
// Use this for the unique machine tag used for session sync.
std::string GetSyncSessionsGUID() const;
void SetSyncSessionsGUID(const std::string& guid);
// Maps |data_type| to its corresponding preference name.
static const char* GetPrefNameForDataType(syncer::ModelType data_type);
#if defined(OS_CHROMEOS)
// Use this spare bootstrap token only when setting up sync for the first
// time.
std::string GetSpareBootstrapToken() const;
void SetSpareBootstrapToken(const std::string& token);
#endif
// Merges the given set of types with the set of acknowledged types.
void AcknowledgeSyncedTypes(syncer::ModelTypeSet types);
// Get/Set number of rollback attempts allowed.
virtual int GetRemainingRollbackTries() const;
virtual void SetRemainingRollbackTries(int times);
// Get/set/clear first sync time of current user. Used to roll back browsing
// data later when user signs out.
base::Time GetFirstSyncTime() const;
void SetFirstSyncTime(base::Time time);
void ClearFirstSyncTime();
// For testing.
void SetManagedForTest(bool is_managed);
syncer::ModelTypeSet GetAcknowledgeSyncedTypesForTest() const;
private:
void RegisterPrefGroups();
static void RegisterDataTypePreferredPref(
user_prefs::PrefRegistrySyncable* prefs,
syncer::ModelType type,
bool is_preferred);
bool GetDataTypePreferred(syncer::ModelType type) const;
void SetDataTypePreferred(syncer::ModelType type, bool is_preferred);
// Returns a ModelTypeSet based on |types| expanded to include pref groups
// (see |pref_groups_|), but as a subset of |registered_types|.
syncer::ModelTypeSet ResolvePrefGroups(syncer::ModelTypeSet registered_types,
syncer::ModelTypeSet types) const;
void OnSyncManagedPrefChanged();
// May be NULL.
PrefService* const pref_service_;
ObserverList<SyncPrefObserver> sync_pref_observers_;
// The preference that controls whether sync is under control by
// configuration management.
BooleanPrefMember pref_sync_managed_;
// Groups of prefs that always have the same value as a "master" pref.
// For example, the APPS group has {APP_NOTIFICATIONS, APP_SETTINGS}
// (as well as APPS, but that is implied), so
// pref_groups_[syncer::APPS] = { syncer::APP_NOTIFICATIONS,
// syncer::APP_SETTINGS }
// pref_groups_[syncer::EXTENSIONS] = { syncer::EXTENSION_SETTINGS }
// etc.
typedef std::map<syncer::ModelType, syncer::ModelTypeSet> PrefGroupsMap;
PrefGroupsMap pref_groups_;
DISALLOW_COPY_AND_ASSIGN(SyncPrefs);
};
} // namespace sync_driver
#endif // COMPONENTS_SYNC_DRIVER_SYNC_PREFS_H_
|