0
Files
src/content/browser/field_trial_synchronizer.h
Ben Goldberger 72533cd919 Rename 'variations_http_header_provider' to 'variations_ids_provider'.
Follow up to https://chromium-review.googlesource.com/c/chromium/src/+/2196817

Bug: 1079458
Change-Id: I22dc45f0399b3978e494ab20b66ef5126ccea580
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/2231906
Auto-Submit: Ben Goldberger <benwgold@google.com>
Reviewed-by: Theresa  <twellington@chromium.org>
Reviewed-by: Yaron Friedman <yfriedman@chromium.org>
Reviewed-by: Alexei Svitkine <asvitkine@chromium.org>
Commit-Queue: Yaron Friedman <yfriedman@chromium.org>
Cr-Commit-Position: refs/heads/master@{#790414}
2020-07-21 16:11:38 +00:00

77 lines
3.2 KiB
C++

// Copyright (c) 2012 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.
#ifndef CONTENT_BROWSER_FIELD_TRIAL_SYNCHRONIZER_H_
#define CONTENT_BROWSER_FIELD_TRIAL_SYNCHRONIZER_H_
#include <string>
#include <vector>
#include "base/macros.h"
#include "base/memory/ref_counted.h"
#include "base/metrics/field_trial.h"
#include "components/variations/variations_ids_provider.h"
namespace content {
class RenderProcessHost;
// This class is used by the browser process to communicate FieldTrial setting
// (field trial name and group) and Variation header to any previously started
// renderers.
//
// This class registers itself as an observer of FieldTrialList. FieldTrialList
// notifies this class by calling it's OnFieldTrialGroupFinalized method when a
// group is selected (finalized) for a FieldTrial and OnFieldTrialGroupFinalized
// method sends the FieldTrial's name and the group to all renderer processes.
// Each renderer process creates the FieldTrial, and by using a 100% probability
// for the FieldTrial, forces the FieldTrial to have the same group string.
// This class also registers itself as a VariationsIdsProvider Observer
// and updates the renderers if the variations header changes.
class FieldTrialSynchronizer
: public base::RefCountedThreadSafe<FieldTrialSynchronizer>,
public base::FieldTrialList::Observer,
public variations::VariationsIdsProvider::Observer {
public:
// Construction also sets up the global singleton instance. This instance is
// used to communicate between the UI and other threads, and is destroyed only
// as the main thread (browser_main) terminates, which means all other threads
// have completed, and will not need this instance any further. It adds itself
// as an observer of FieldTrialList so that it gets notified whenever a group
// is finalized in the browser process.
FieldTrialSynchronizer();
// FieldTrialList::Observer methods:
// This method is called by the FieldTrialList singleton when a trial's group
// is finalized. This method contacts all renderers (by calling
// NotifyAllRenderers) to create a FieldTrial that carries the randomly
// selected state from the browser process into all the renderer processes.
void OnFieldTrialGroupFinalized(const std::string& name,
const std::string& group_name) override;
// VariationsIdsProvider::Observer methods:
void VariationIdsHeaderUpdated() override;
// Sends the current variations header to |host|'s renderer.
static void UpdateRendererVariationsHeader(RenderProcessHost* host);
private:
// Notify all renderer processes about the |group_name| that is finalized for
// the given field trail (|field_trial_name|). This is called on UI thread.
void NotifyAllRenderersOfFieldTrial(const std::string& field_trial_name,
const std::string& group_name);
static void NotifyAllRenderersOfVariationsHeader();
friend class base::RefCountedThreadSafe<FieldTrialSynchronizer>;
~FieldTrialSynchronizer() override;
DISALLOW_COPY_AND_ASSIGN(FieldTrialSynchronizer);
};
} // namespace content
#endif // CONTENT_BROWSER_FIELD_TRIAL_SYNCHRONIZER_H_