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
|
// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef NET_FIRST_PARTY_SETS_FIRST_PARTY_SETS_CONTEXT_CONFIG_H_
#define NET_FIRST_PARTY_SETS_FIRST_PARTY_SETS_CONTEXT_CONFIG_H_
#include <optional>
#include "base/containers/flat_map.h"
#include "base/functional/function_ref.h"
#include "net/base/schemeful_site.h"
#include "net/first_party_sets/first_party_set_entry_override.h"
namespace mojo {
template <typename DataViewType, typename T>
struct StructTraits;
} // namespace mojo
namespace network::mojom {
class FirstPartySetsContextConfigDataView;
} // namespace network::mojom
namespace net {
// This struct bundles together the customized settings to First-Party Sets
// info in the given network context.
class NET_EXPORT FirstPartySetsContextConfig {
public:
FirstPartySetsContextConfig();
// Factory method that validates all preconditions, returning `std::nullopt`
// if any are violated.
static std::optional<FirstPartySetsContextConfig> Create(
base::flat_map<SchemefulSite, FirstPartySetEntryOverride> customizations,
base::flat_map<SchemefulSite, SchemefulSite> aliases = {});
FirstPartySetsContextConfig(FirstPartySetsContextConfig&& other);
FirstPartySetsContextConfig& operator=(FirstPartySetsContextConfig&& other);
~FirstPartySetsContextConfig();
FirstPartySetsContextConfig Clone() const;
bool operator==(const FirstPartySetsContextConfig& other) const;
bool empty() const { return customizations_.empty(); }
// Finds an override for the given site, in this context. Returns:
// - nullopt if no override was found.
// - optional(override) if an override was found. The override may be a
// deletion or a modification/addition.
std::optional<FirstPartySetEntryOverride> FindOverride(
const SchemefulSite& site) const;
// Returns whether an override can be found for the given site in this
// context.
bool Contains(const SchemefulSite& site) const;
// Synchronously iterate over all the override entries. Each iteration will be
// invoked with the relevant site and the override that applies to it.
//
// Returns early if any of the iterations returns false. Returns false if
// iteration was incomplete; true if all iterations returned true. No
// guarantees are made re: iteration order.
bool ForEachCustomizationEntry(
base::FunctionRef<bool(const SchemefulSite&,
const FirstPartySetEntryOverride&)> f) const;
// Synchronously iterates over all the aliases, calling `f` on each pair of
// (alias, canonical site).
void ForEachAlias(base::FunctionRef<void(const SchemefulSite&,
const SchemefulSite&)> f) const;
private:
// mojo (de)serialization needs access to private details.
friend struct mojo::StructTraits<
network::mojom::FirstPartySetsContextConfigDataView,
FirstPartySetsContextConfig>;
FirstPartySetsContextConfig(
base::flat_map<SchemefulSite, FirstPartySetEntryOverride> customizations,
base::flat_map<SchemefulSite, SchemefulSite> aliases);
// All custom entries, including aliases.
base::flat_map<SchemefulSite, FirstPartySetEntryOverride> customizations_;
// The alias customizations.
base::flat_map<SchemefulSite, SchemefulSite> aliases_;
};
} // namespace net
#endif // NET_FIRST_PARTY_SETS_FIRST_PARTY_SETS_CONTEXT_CONFIG_H_
|
