Index: chrome/common/metrics/experiments_helper.h |
diff --git a/chrome/common/metrics/experiments_helper.h b/chrome/common/metrics/experiments_helper.h |
index 102e6351c75795bfff3d624294d5b8a89f06f2d9..57d6037b2173a972f1c8cd9f84ee9d687a5715c6 100644 |
--- a/chrome/common/metrics/experiments_helper.h |
+++ b/chrome/common/metrics/experiments_helper.h |
@@ -28,17 +28,14 @@ |
// const int kLowMemGroup = trial->AppendGroup("LowMem", 20); |
// // All groups are now created. We want to associate GoogleExperimentIDs with |
// // them, so do that now. |
-// AssociateGoogleExperimentID( |
-// FieldTrial::MakeNameGroupId("trial", "default"), 123); |
-// AssociateGoogleExperimentID( |
-// FieldTrial::MakeNameGroupId("trial", "HighMem"), 456); |
-// AssociateGoogleExperimentID( |
-// FieldTrial::MakeNameGroupId("trial", "LowMem"), 789); |
+// AssociateGoogleExperimentID(MakeNameGroupId("trial", "default"), 123); |
+// AssociateGoogleExperimentID(MakeNameGroupId("trial", "HighMem"), 456); |
+// AssociateGoogleExperimentID(MakeNameGroupId("trial", "LowMem"), 789); |
// |
// // Elsewhere, we are interested in retrieving the GoogleExperimentID |
// // assocaited with |trial|. |
// GoogleExperimentID id = GetGoogleExperimentID( |
-// FieldTrial::MakeNameGroupId(trial->name(), trial->group_name())); |
+// MakeNameGroupId(trial->name(), trial->group_name())); |
// // Do stuff with |id|... |
// |
// The AssociateGoogleExperimentID and GetGoogleExperimentID API methods are |
@@ -48,27 +45,55 @@ namespace experiments_helper { |
// An ID used by Google servers to identify a local browser experiment. |
typedef uint32 GoogleExperimentID; |
+// The Unique ID of a trial, where the name and group identifiers are |
+// hashes of the trial and group name strings. |
+struct NameGroupId { |
+ uint32 name; |
+ uint32 group; |
+}; |
+ |
+// We need to supply a Compare class for templates since NameGroupId is a |
+// user-defined type. |
+struct NameGroupIdCompare { |
+ bool operator() (const experiments_helper::NameGroupId& lhs, |
MAD
2012/04/26 19:40:13
I don't think you need the namespace scope in here
SteveT
2012/04/26 21:06:03
Yup, thanks for the catch :)
Oh, and you're okay
|
+ const experiments_helper::NameGroupId& rhs) const { |
+ // The group and name fields are just SHA-1 Hashes, so we just need to treat |
+ // them as IDs and do a less-than comparison. We test group first, since |
+ // name is more likely to collide. |
+ return lhs.group == rhs.group ? lhs.name < rhs.name : |
+ lhs.group < rhs.group; |
+ } |
+}; |
+ |
// Used to represent no associated Google experiment ID. Calls to the |
// GetGoogleExperimentID API below will return this empty value for FieldTrial |
// groups uninterested in associating themselves with Google experiments, or |
// those that have not yet been seen yet. |
extern const GoogleExperimentID kEmptyGoogleExperimentID; |
+// Returns an array of Unique IDs for each Field Trial that has a chosen |
+// group. Field Trials for which a group has not been chosen yet are NOT |
+// returned in this list. In the real world, clients should use |
+// GetFieldTrialNameGroupIds. |
+void GetFieldTrialNameGroupIds(std::vector<NameGroupId>* name_group_ids); |
+ |
+// Helper function to create a NameGroupId from |trial_name| and |group_name|. |
+NameGroupId MakeNameGroupId(const std::string& trial_name, |
+ const std::string& group_name); |
+ |
// Set the GoogleExperimentID associated with a FieldTrial group. The group is |
// denoted by |group_identifier|, which can be created by passing the |
// FieldTrial's trial and group names to base::FieldTrial::MakeNameGroupId. |
// This does not need to be called for FieldTrials uninterested in Google |
// experiments. |
-void AssociateGoogleExperimentID( |
- const base::FieldTrial::NameGroupId& group_identifier, |
- GoogleExperimentID id); |
+void AssociateGoogleExperimentID(const NameGroupId& group_identifier, |
+ GoogleExperimentID id); |
// Retrieve the GoogleExperimentID associated with a FieldTrial group. The group |
// is denoted by |group_identifier| (see comment above). This can be nicely |
// combined with FieldTrial::GetFieldTrialNameGroupIds to enumerate the |
// GoogleExperimentIDs for all active FieldTrial groups. |
-GoogleExperimentID GetGoogleExperimentID( |
- const base::FieldTrial::NameGroupId& group_identifier); |
+GoogleExperimentID GetGoogleExperimentID(const NameGroupId& group_identifier); |
// Get the current set of chosen FieldTrial groups (aka experiments) and send |
// them to the child process logging module so it can save it for crash dumps. |
@@ -76,4 +101,20 @@ void SetChildProcessLoggingExperimentList(); |
} // namespace experiments_helper |
+// Expose a couple functions for testing. These functions will just wrap |
+// functionality that is implemented above. |
+namespace testing { |
+ |
+void TestGetFieldTrialNameGroupIdsForSelectedGroups( |
+ const base::FieldTrial::SelectedGroups& selected_groups, |
+ std::vector<experiments_helper::NameGroupId>* name_group_ids); |
+ |
+experiments_helper::NameGroupId TestMakeNameGroupId( |
MAD
2012/04/26 19:40:13
I don't think you need TestMakeNameGroupId since t
SteveT
2012/04/26 21:06:03
We discussed changing the API to accept strings an
|
+ const std::string& trial_name, |
+ const std::string& group_name); |
+ |
+uint32 TestHashName(const std::string& name); |
+ |
+} |
+ |
#endif // CHROME_COMMON_METRICS_EXPERIMENTS_HELPER_H_ |