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
|
// Copyright 2013 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROMEOS_ASH_COMPONENTS_SETTINGS_CROS_SETTINGS_PROVIDER_H_
#define CHROMEOS_ASH_COMPONENTS_SETTINGS_CROS_SETTINGS_PROVIDER_H_
#include <string>
#include <string_view>
#include "base/component_export.h"
#include "base/functional/callback.h"
namespace base {
class Value;
} // namespace base
namespace ash {
class COMPONENT_EXPORT(CHROMEOS_ASH_COMPONENTS_SETTINGS) CrosSettingsProvider {
public:
// The callback type that is called to notify the CrosSettings observers
// about a setting change.
using NotifyObserversCallback =
base::RepeatingCallback<void(const std::string&)>;
// Possible results of a trusted check.
enum TrustedStatus {
// The trusted values were populated in the cache and can be accessed
// until the next iteration of the message loop.
TRUSTED,
// Either a store or a load operation is in progress. The provided
// callback will be invoked once the verification has finished.
TEMPORARILY_UNTRUSTED,
// The verification of the trusted store has failed permanently. The
// client should assume this state final and further checks for
// trustedness will fail at least until the browser restarts.
PERMANENTLY_UNTRUSTED,
};
// Creates a new provider instance. |notify_cb| will be used to notify
// about setting changes.
explicit CrosSettingsProvider(const NotifyObserversCallback& notify_cb);
virtual ~CrosSettingsProvider();
// Gets settings value of given |path| to |out_value|.
virtual const base::Value* Get(std::string_view path) const = 0;
// Requests the provider to fetch its values from a trusted store, if it
// hasn't done so yet. Returns TRUSTED if the values returned by this provider
// are trusted during the current loop cycle. Otherwise returns
// TEMPORARILY_UNTRUSTED, takes ownership of |callback|, and will invoke it
// later when trusted values become available. PrepareTrustedValues() should
// be tried again in that case. Returns PERMANENTLY_UNTRUSTED if a permanent
// error has occurred.
virtual TrustedStatus PrepareTrustedValues(base::OnceClosure* callback) = 0;
// Gets the namespace prefix provided by this provider.
virtual bool HandlesSetting(std::string_view path) const = 0;
void SetNotifyObserversCallback(const NotifyObserversCallback& notify_cb);
protected:
// Notifies the observers about a setting change.
void NotifyObservers(const std::string& path);
private:
// Callback used to notify about setting changes.
NotifyObserversCallback notify_cb_;
};
} // namespace ash
#endif // CHROMEOS_ASH_COMPONENTS_SETTINGS_CROS_SETTINGS_PROVIDER_H_
|
