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
|
// 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 COMPONENTS_PREFS_PREF_FILTER_H_
#define COMPONENTS_PREFS_PREF_FILTER_H_
#include <string_view>
#include <utility>
#include "base/functional/callback_forward.h"
#include "base/memory/weak_ptr.h"
#include "base/values.h"
#include "components/prefs/prefs_export.h"
class PrefService;
// Filters preferences as they are loaded from disk or updated at runtime.
// Currently supported only by JsonPrefStore.
class COMPONENTS_PREFS_EXPORT PrefFilter {
public:
// A pair of pre-write and post-write callbacks.
using OnWriteCallbackPair =
std::pair<base::OnceClosure, base::OnceCallback<void(bool success)>>;
// A callback to be invoked when |prefs| have been read (and possibly
// pre-modified) and are now ready to be handed back to this callback's
// builder. |schedule_write| indicates whether a write should be immediately
// scheduled (typically because the |prefs| were pre-modified).
using PostFilterOnLoadCallback =
base::OnceCallback<void(base::Value::Dict prefs, bool schedule_write)>;
virtual ~PrefFilter() = default;
// This method is given ownership of the |pref_store_contents| read from disk
// before the underlying PersistentPrefStore gets to use them. It must hand
// them back via |post_filter_on_load_callback|, but may modify them first.
// Note: This method is asynchronous, which may make calls like
// PersistentPrefStore::ReadPrefs() asynchronous. The owner of filtered
// PersistentPrefStores should handle this to make the reads look synchronous
// to external users (see SegregatedPrefStore::ReadPrefs() for an example).
virtual void FilterOnLoad(
PostFilterOnLoadCallback post_filter_on_load_callback,
base::Value::Dict pref_store_contents) = 0;
// Receives notification when a pref store value is changed, before Observers
// are notified.
virtual void FilterUpdate(std::string_view path) = 0;
// Receives notification when the pref store is about to serialize data
// contained in |pref_store_contents| to a string. Modifications to
// |pref_store_contents| will be persisted to disk and also affect the
// in-memory state.
// If the returned callbacks are non-null, they will be registered to be
// invoked synchronously after the next write (from the I/O TaskRunner so they
// must not be bound to thread-unsafe member state).
virtual OnWriteCallbackPair FilterSerializeData(
base::Value::Dict& pref_store_contents) = 0;
// Cleans preference data that may have been saved outside of the store.
virtual void OnStoreDeletionFromDisk() = 0;
// Allows a PrefService to be injected into the filter class.
virtual void SetPrefService(PrefService* pref_service) = 0;
};
#endif // COMPONENTS_PREFS_PREF_FILTER_H_
|
