Framework to ascribe all network data use to a source.

components/data_use_measurement/core/data_use_ascriber.h

Index: components/data_use_measurement/core/data_use_ascriber.h
diff --git a/components/data_use_measurement/core/data_use_ascriber.h b/components/data_use_measurement/core/data_use_ascriber.h
new file mode 100644
index 0000000000000000000000000000000000000000..5bcfe618bfb0fee0e0ffd24a16b611a21eed2db6
--- /dev/null
+++ b/components/data_use_measurement/core/data_use_ascriber.h
@@ -0,0 +1,34 @@
+// Copyright 2016 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_DATA_USE_MEASUREMENT_CORE_DATA_USE_ASCRIBER_H_
+#define COMPONENTS_DATA_USE_MEASUREMENT_CORE_DATA_USE_ASCRIBER_H_
+
+namespace net {
+class URLRequest;
+}
+
+namespace data_use_measurement {
+
+class DataUseRecorder;
+
+// Abstract class that manages instances of |DataUseRecorder| and maps

[bengr, 2016/09/01 00:16:55]

-> maps a |URLRequest| instance to its ...

[Not at Google. Contact bengr, 2016/09/07 23:38:38]

Done.

+// |URLRequest| instances to their appropriate |DataUseRecorder|. Applications

[bengr, 2016/09/01 00:16:55]

Applications -> An embedder

[Not at Google. Contact bengr, 2016/09/07 23:38:38]

Done.

+// should provide overrides if they are interested in tracking data usage

[bengr, 2016/09/01 00:16:55]

overrides -> an override
if they are -> if it is

[Not at Google. Contact bengr, 2016/09/07 23:38:38]

Done.

+// and surfacing it to the end user. Data use from all URLRequests mapped to the

[bengr, 2016/09/01 00:16:55]

Why does it matter that it is surfaced to the end user. I'd drop this clause.

[Not at Google. Contact bengr, 2016/09/07 23:38:38]

Done.

+// same |DataUseRecorder| will be grouped together and reported as a single use.
+class DataUseAscriber {
+ public:
+  virtual ~DataUseAscriber() {}
+
+  // Returns the |DataUseRecorder| to which data usage for the given URL should
+  // be ascribed. If no existing |DataUseRecorder| exists, a new one will be
+  // created.
+  virtual DataUseRecorder* GetDataUseRecorder(
+      const net::URLRequest* request) = 0;
+};
+
+}  // namespace data_use_measurement
+
+#endif  // COMPONENTS_DATA_USE_MEASUREMENT_CORE_DATA_USE_ASCRIBER_H_