RAPPOR implementation

components/rappor/rappor_service.h

+// Copyright (c) 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.
+
+#ifndef COMPONENTS_RAPPOR_RAPPOR_SERVICE_H_
+#define COMPONENTS_RAPPOR_RAPPOR_SERVICE_H_
+
+#include <string>
+#include <vector>
+
+#include "base/basictypes.h"
+#include "base/lazy_instance.h"
+#include "base/memory/weak_ptr.h"
+#include "base/prefs/pref_service.h"
+#include "base/time/time.h"
+#include "base/timer/timer.h"
+#include "components/rappor/log_uploader.h"
+#include "components/rappor/proto/rappor_metric.pb.h"
+
+class PrefRegistrySimple;
+
+namespace rappor {
+
+// This class provides base functionality for logging rappor data.
+class RapporService {
+ public:
+  RapporService();
+  virtual ~RapporService();
+
+  // Starts the rappord system.  Should be called when starting up.
+  void Start(PrefService* pref_service, net::URLRequestContextGetter* context);
+
+  // At startup, prefs needs to be called with a list of all the pref names and
+  // types we'll be using.
+  static void RegisterPrefs(PrefRegistrySimple* registry);
+
+ private:
+  friend class RapporServiceTest;
+
+  // Client side secret used to generate fake bits.
+  std::string rappor_secret_;
+
+  RapporMetricsProto rappor_metrics_proto_;
+
+  // Timer which schedules calls OnLogInterval()
+  base::OneShotTimer<RapporService> log_rotation_timer_;
+
+  LogUploader uploader_;
+
+  // Generates a rappor_secret and stores it in preferences.  If already stored,
+  // just retreives the stored value.
+  void GenerateRapporSecret(PrefService* pref_service);
+
+  // Records a single Rappor value to the rappor_metrics_proto_.
+  void RecordRapporMetric(const std::string& metric_name,
+                          const std::vector<uint8_t> bytes);
+
+  // Records all of the collected Rappor metrics to the rappor_metric_proto_.
+  void RecordRapporMetrics();
+
+  // Called whenever the logging interval elapses.
+  void OnLogInterval();
+
+  DISALLOW_COPY_AND_ASSIGN(RapporService);
+};
+
+}  // namespace rappor
+
+#endif  // COMPONENTS_RAPPOR_RAPPOR_SERVICE_H_