RAPPOR implementation

components/rappor/rappor_metric.h

Index: components/rappor/rappor_metric.h
diff --git a/components/rappor/rappor_metric.h b/components/rappor/rappor_metric.h
new file mode 100644
index 0000000000000000000000000000000000000000..308d762f2e443b738aa75b0be5f050bb99000b15
--- /dev/null
+++ b/components/rappor/rappor_metric.h
@@ -0,0 +1,49 @@
+// 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 COMPONENTS_RAPPOR_RAPPOR_H_
+#define COMPONENTS_RAPPOR_RAPPOR_H_
+
+#include <assert.h>
+#include <limits.h>
+#include <math.h>
+
+#include <string>
+#include <vector>
+
+#include "components/rappor/bloom_filter.h"
+#include "components/rappor/byte_vector_utils.h"
+#include "components/rappor/rappor_parameters.h"
+
+namespace rappor {
+
+// A RapporMetric is an object for collects string samples into a bloom filter,

[Ilya Sherman, 2014/01/10 11:00:32]

nit: "for collects" -> "that collects" or "for collecting"

[Steven Holte, 2014/01/14 00:47:54]

Done.

+// and generates randomized reports about the collected data.
+//
+// For a full description of the rappor metrics, see
+// http://www.chromium.org/developers/design-documents/rappor

[Ilya Sherman, 2014/01/10 11:00:32]

I'm going to insist that it's important to have thorough documentation available
at this link *prior* to landing this CL.

[Steven Holte, 2014/01/14 00:47:54]

That is the plan.  Ulfar has told me to expect an updated design doc from the
privacy team, so I'm waiting on that.

+class RapporMetric {
+ public:
+  RapporMetric(const RapporParameters& parameters);
+
+  // Record additional samples in the bloom filter.
+  void AddSamples(const std::vector<std::string>& strings);
+  void AddSample(const std::string& str);
+
+  // Retrieves the current bloom filter bits.
+  const ByteVector& GetBytes() const;
+  const RapporParameters* parameters() const { return &parameters_; }
+
+  ByteVector GetReport(const std::string& secret) const;
+
+ private:
+  const RapporParameters parameters_;
+  BloomFilter bloom_;
+
+  DISALLOW_COPY_AND_ASSIGN(RapporMetric);
+};
+
+}  // namespace rappor
+
+#endif  // COMPONENTS_RAPPOR_RAPPOR_H_