// 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/variations_seed_processor.h"
#include <map>
#include <set>
#include <vector>
#include "base/command_line.h"
#include "base/metrics/field_trial.h"
#include "base/stl_util.h"
#include "base/version.h"
#include "components/variations/processed_study.h"
#include "components/variations/variations_associated_data.h"
namespace chrome_variations {
namespace {
Study_Platform GetCurrentPlatform() {
#if defined(OS_WIN)
return Study_Platform_PLATFORM_WINDOWS;
#elif defined(OS_IOS)
return Study_Platform_PLATFORM_IOS;
#elif defined(OS_MACOSX)
return Study_Platform_PLATFORM_MAC;
#elif defined(OS_CHROMEOS)
return Study_Platform_PLATFORM_CHROMEOS;
#elif defined(OS_ANDROID)
return Study_Platform_PLATFORM_ANDROID;
#elif defined(OS_LINUX) || defined(OS_BSD) || defined(OS_SOLARIS)
// Default BSD and SOLARIS to Linux to not break those builds, although these
// platforms are not officially supported by Chrome.
return Study_Platform_PLATFORM_LINUX;
#else
#error Unknown platform
#endif
}
// Converts |date_time| in Study date format to base::Time.
base::Time ConvertStudyDateToBaseTime(int64 date_time) {
return base::Time::UnixEpoch() + base::TimeDelta::FromSeconds(date_time);
}
// Associates the variations params of |experiment|, if present.
void RegisterExperimentParams(const Study& study,
const Study_Experiment& experiment) {
std::map<std::string, std::string> params;
for (int i = 0; i < experiment.param_size(); ++i) {
if (experiment.param(i).has_name() && experiment.param(i).has_value())
params[experiment.param(i).name()] = experiment.param(i).value();
}
if (!params.empty())
AssociateVariationParams(study.name(), experiment.name(), params);
}
// If there are variation ids associated with |experiment|, register the
// variation ids.
void RegisterVariationIds(const Study_Experiment& experiment,
const std::string& trial_name) {
if (experiment.has_google_web_experiment_id()) {
const VariationID variation_id =
static_cast<VariationID>(experiment.google_web_experiment_id());
AssociateGoogleVariationIDForce(GOOGLE_WEB_PROPERTIES,
trial_name,
experiment.name(),
variation_id);
}
if (experiment.has_google_update_experiment_id()) {
const VariationID variation_id =
static_cast<VariationID>(experiment.google_update_experiment_id());
AssociateGoogleVariationIDForce(GOOGLE_UPDATE_SERVICE,
trial_name,
experiment.name(),
variation_id);
}
}
} // namespace
VariationsSeedProcessor::VariationsSeedProcessor() {
}
VariationsSeedProcessor::~VariationsSeedProcessor() {
}
bool VariationsSeedProcessor::AllowVariationIdWithForcingFlag(
const Study& study) {
if (!study.has_filter())
return false;
const Study_Filter& filter = study.filter();
if (filter.platform_size() == 0 || filter.channel_size() == 0)
return false;
for (int i = 0; i < filter.platform_size(); ++i) {
if (filter.platform(i) != Study_Platform_PLATFORM_ANDROID &&
filter.platform(i) != Study_Platform_PLATFORM_IOS) {
return false;
}
}
for (int i = 0; i < filter.channel_size(); ++i) {
if (filter.channel(i) != Study_Channel_CANARY &&
filter.channel(i) != Study_Channel_DEV) {
return false;
}
}
return true;
}
void VariationsSeedProcessor::CreateTrialsFromSeed(
const VariationsSeed& seed,
const std::string& locale,
const base::Time& reference_date,
const base::Version& version,
Study_Channel channel,
Study_FormFactor form_factor) {
std::vector<ProcessedStudy> filtered_studies;
FilterAndValidateStudies(seed, locale, reference_date, version, channel,
form_factor, &filtered_studies);
for (size_t i = 0; i < filtered_studies.size(); ++i)
CreateTrialFromStudy(filtered_studies[i]);
}
void VariationsSeedProcessor::FilterAndValidateStudies(
const VariationsSeed& seed,
const std::string& locale,
const base::Time& reference_date,
const base::Version& version,
Study_Channel channel,
Study_FormFactor form_factor,
std::vector<ProcessedStudy>* filtered_studies) {
DCHECK(version.IsValid());
// Add expired studies (in a disabled state) only after all the non-expired
// studies have been added (and do not add an expired study if a corresponding
// non-expired study got added). This way, if there's both an expired and a
// non-expired study that applies, the non-expired study takes priority.
std::set<std::string> created_studies;
std::vector<const Study*> expired_studies;
for (int i = 0; i < seed.study_size(); ++i) {
const Study& study = seed.study(i);
if (!ShouldAddStudy(study, locale, reference_date,
version, channel, form_factor))
continue;
if (IsStudyExpired(study, reference_date)) {
expired_studies.push_back(&study);
} else if (!ContainsKey(created_studies, study.name())) {
ProcessedStudy::ValidateAndAppendStudy(&study, false, filtered_studies);
created_studies.insert(study.name());
}
}
for (size_t i = 0; i < expired_studies.size(); ++i) {
if (!ContainsKey(created_studies, expired_studies[i]->name())) {
ProcessedStudy::ValidateAndAppendStudy(expired_studies[i], true,
filtered_studies);
}
}
}
bool VariationsSeedProcessor::CheckStudyChannel(const Study_Filter& filter,
Study_Channel channel) {
// An empty channel list matches all channels.
if (filter.channel_size() == 0)
return true;
for (int i = 0; i < filter.channel_size(); ++i) {
if (filter.channel(i) == channel)
return true;
}
return false;
}
bool VariationsSeedProcessor::CheckStudyFormFactor(
const Study_Filter& filter,
Study_FormFactor form_factor) {
// An empty form factor list matches all form factors.
if (filter.form_factor_size() == 0)
return true;
for (int i = 0; i < filter.form_factor_size(); ++i) {
if (filter.form_factor(i) == form_factor)
return true;
}
return false;
}
bool VariationsSeedProcessor::CheckStudyLocale(
const Study_Filter& filter,
const std::string& locale) {
// An empty locale list matches all locales.
if (filter.locale_size() == 0)
return true;
for (int i = 0; i < filter.locale_size(); ++i) {
if (filter.locale(i) == locale)
return true;
}
return false;
}
bool VariationsSeedProcessor::CheckStudyPlatform(
const Study_Filter& filter,
Study_Platform platform) {
// An empty platform list matches all platforms.
if (filter.platform_size() == 0)
return true;
for (int i = 0; i < filter.platform_size(); ++i) {
if (filter.platform(i) == platform)
return true;
}
return false;
}
bool VariationsSeedProcessor::CheckStudyStartDate(
const Study_Filter& filter,
const base::Time& date_time) {
if (filter.has_start_date()) {
const base::Time start_date =
ConvertStudyDateToBaseTime(filter.start_date());
return date_time >= start_date;
}
return true;
}
bool VariationsSeedProcessor::CheckStudyVersion(
const Study_Filter& filter,
const base::Version& version) {
if (filter.has_min_version()) {
if (version.CompareToWildcardString(filter.min_version()) < 0)
return false;
}
if (filter.has_max_version()) {
if (version.CompareToWildcardString(filter.max_version()) > 0)
return false;
}
return true;
}
void VariationsSeedProcessor::CreateTrialFromStudy(
const ProcessedStudy& processed_study) {
const Study& study = *processed_study.study();
// Check if any experiments need to be forced due to a command line
// flag. Force the first experiment with an existing flag.
CommandLine* command_line = CommandLine::ForCurrentProcess();
for (int i = 0; i < study.experiment_size(); ++i) {
const Study_Experiment& experiment = study.experiment(i);
if (experiment.has_forcing_flag() &&
command_line->HasSwitch(experiment.forcing_flag())) {
base::FieldTrialList::CreateFieldTrial(study.name(), experiment.name());
RegisterExperimentParams(study, experiment);
DVLOG(1) << "Trial " << study.name() << " forced by flag: "
<< experiment.forcing_flag();
if (AllowVariationIdWithForcingFlag(study))
RegisterVariationIds(experiment, study.name());
return;
}
}
uint32 randomization_seed = 0;
base::FieldTrial::RandomizationType randomization_type =
base::FieldTrial::SESSION_RANDOMIZED;
if (study.has_consistency() &&
study.consistency() == Study_Consistency_PERMANENT) {
randomization_type = base::FieldTrial::ONE_TIME_RANDOMIZED;
if (study.has_randomization_seed())
randomization_seed = study.randomization_seed();
}
// The trial is created without specifying an expiration date because the
// expiration check in field_trial.cc is based on the build date. Instead,
// the expiration check using |reference_date| is done explicitly below.
scoped_refptr<base::FieldTrial> trial(
base::FieldTrialList::FactoryGetFieldTrialWithRandomizationSeed(
study.name(), processed_study.total_probability(),
study.default_experiment_name(),
base::FieldTrialList::kNoExpirationYear, 1, 1, randomization_type,
randomization_seed, NULL));
for (int i = 0; i < study.experiment_size(); ++i) {
const Study_Experiment& experiment = study.experiment(i);
RegisterExperimentParams(study, experiment);
// Groups with forcing flags have probability 0 and will never be selected.
// Therefore, there's no need to add them to the field trial.
if (experiment.has_forcing_flag())
continue;
if (experiment.name() != study.default_experiment_name())
trial->AppendGroup(experiment.name(), experiment.probability_weight());
RegisterVariationIds(experiment, study.name());
}
trial->SetForced();
if (processed_study.is_expired())
trial->Disable();
else if (study.activation_type() == Study_ActivationType_ACTIVATION_AUTO)
trial->group();
}
bool VariationsSeedProcessor::IsStudyExpired(const Study& study,
const base::Time& date_time) {
if (study.has_expiry_date()) {
const base::Time expiry_date =
ConvertStudyDateToBaseTime(study.expiry_date());
return date_time >= expiry_date;
}
return false;
}
bool VariationsSeedProcessor::ShouldAddStudy(
const Study& study,
const std::string& locale,
const base::Time& reference_date,
const base::Version& version,
Study_Channel channel,
Study_FormFactor form_factor) {
if (study.has_filter()) {
if (!CheckStudyChannel(study.filter(), channel)) {
DVLOG(1) << "Filtered out study " << study.name() << " due to channel.";
return false;
}
if (!CheckStudyFormFactor(study.filter(), form_factor)) {
DVLOG(1) << "Filtered out study " << study.name() <<
" due to form factor.";
return false;
}
if (!CheckStudyLocale(study.filter(), locale)) {
DVLOG(1) << "Filtered out study " << study.name() << " due to locale.";
return false;
}
if (!CheckStudyPlatform(study.filter(), GetCurrentPlatform())) {
DVLOG(1) << "Filtered out study " << study.name() << " due to platform.";
return false;
}
if (!CheckStudyVersion(study.filter(), version)) {
DVLOG(1) << "Filtered out study " << study.name() << " due to version.";
return false;
}
if (!CheckStudyStartDate(study.filter(), reference_date)) {
DVLOG(1) << "Filtered out study " << study.name() <<
" due to start date.";
return false;
}
}
DVLOG(1) << "Kept study " << study.name() << ".";
return true;
}
} // namespace chrome_variations