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
|
// 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.
#include "components/variations/processed_study.h"
#include <set>
#include <string>
#include "base/logging.h"
#include "base/version.h"
#include "components/variations/proto/study.pb.h"
namespace variations {
namespace {
// Validates the sanity of |study| and computes the total probability and
// whether all assignments are to a single group.
bool ValidateStudyAndComputeTotalProbability(
const Study& study,
base::FieldTrial::Probability* total_probability,
bool* all_assignments_to_one_group,
std::vector<std::string>* associated_features) {
if (study.filter().has_min_version() &&
!base::Version::IsValidWildcardString(study.filter().min_version())) {
DVLOG(1) << study.name() << " has invalid min version: "
<< study.filter().min_version();
return false;
}
if (study.filter().has_max_version() &&
!base::Version::IsValidWildcardString(study.filter().max_version())) {
DVLOG(1) << study.name() << " has invalid max version: "
<< study.filter().max_version();
return false;
}
const std::string& default_group_name = study.default_experiment_name();
base::FieldTrial::Probability divisor = 0;
bool multiple_assigned_groups = false;
bool found_default_group = false;
std::set<std::string> experiment_names;
std::set<std::string> features_to_associate;
for (int i = 0; i < study.experiment_size(); ++i) {
const Study_Experiment& experiment = study.experiment(i);
if (experiment.name().empty()) {
DVLOG(1) << study.name() << " is missing experiment " << i << " name";
return false;
}
if (!experiment_names.insert(experiment.name()).second) {
DVLOG(1) << study.name() << " has a repeated experiment name "
<< study.experiment(i).name();
return false;
}
// Note: This checks for ACTIVATE_ON_QUERY, since there is no reason to
// have this association with ACTIVATE_ON_STARTUP (where the trial starts
// active), as well as allowing flexibility to disable this behavior in the
// future from the server by introducing a new activation type.
if (study.activation_type() == Study_ActivationType_ACTIVATE_ON_QUERY) {
const auto& features = experiment.feature_association();
for (int i = 0; i < features.enable_feature_size(); ++i) {
features_to_associate.insert(features.enable_feature(i));
}
for (int i = 0; i < features.disable_feature_size(); ++i) {
features_to_associate.insert(features.disable_feature(i));
}
}
if (!experiment.has_forcing_flag() && experiment.probability_weight() > 0) {
// If |divisor| is not 0, there was at least one prior non-zero group.
if (divisor != 0)
multiple_assigned_groups = true;
divisor += experiment.probability_weight();
}
if (study.experiment(i).name() == default_group_name)
found_default_group = true;
}
// Specifying a default experiment is optional, so finding it in the
// experiment list is only required when it is specified.
if (!study.default_experiment_name().empty() && !found_default_group) {
DVLOG(1) << study.name() << " is missing default experiment ("
<< study.default_experiment_name() << ") in its experiment list";
// The default group was not found in the list of groups. This study is not
// valid.
return false;
}
// Ensure that groups that don't explicitly enable/disable any features get
// associated with all features in the study (i.e. so "Default" group gets
// reported).
if (!features_to_associate.empty()) {
associated_features->insert(associated_features->end(),
features_to_associate.begin(),
features_to_associate.end());
}
*total_probability = divisor;
*all_assignments_to_one_group = !multiple_assigned_groups;
return true;
}
} // namespace
// static
const char ProcessedStudy::kGenericDefaultExperimentName[] =
"VariationsDefaultExperiment";
ProcessedStudy::ProcessedStudy() {}
ProcessedStudy::ProcessedStudy(const ProcessedStudy& other) = default;
ProcessedStudy::~ProcessedStudy() {
}
bool ProcessedStudy::Init(const Study* study, bool is_expired) {
base::FieldTrial::Probability total_probability = 0;
bool all_assignments_to_one_group = false;
std::vector<std::string> associated_features;
if (!ValidateStudyAndComputeTotalProbability(*study, &total_probability,
&all_assignments_to_one_group,
&associated_features)) {
return false;
}
study_ = study;
is_expired_ = is_expired;
total_probability_ = total_probability;
all_assignments_to_one_group_ = all_assignments_to_one_group;
associated_features_.swap(associated_features);
return true;
}
int ProcessedStudy::GetExperimentIndexByName(const std::string& name) const {
for (int i = 0; i < study_->experiment_size(); ++i) {
if (study_->experiment(i).name() == name)
return i;
}
return -1;
}
const char* ProcessedStudy::GetDefaultExperimentName() const {
if (study_->default_experiment_name().empty())
return kGenericDefaultExperimentName;
return study_->default_experiment_name().c_str();
}
// static
bool ProcessedStudy::ValidateAndAppendStudy(
const Study* study,
bool is_expired,
std::vector<ProcessedStudy>* processed_studies) {
ProcessedStudy processed_study;
if (processed_study.Init(study, is_expired)) {
processed_studies->push_back(processed_study);
return true;
}
return false;
}
} // namespace variations
|
