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..55c369757185a981ff8a74f11beb38a065a44ea5
--- /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
+// a |URLRequest| instance to its appropriate |DataUseRecorder|. An enbedder

[Lei Zhang, 2016/09/08 22:04:43]

typo - embedder

[Not at Google. Contact bengr, 2016/09/09 18:37:17]

Done.

+// should provide an override if it is interested in tracking data usage. Data
+// use from all URLRequests mapped to the 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(

[Lei Zhang, 2016/09/08 22:04:43]

To be clear, the Ascriber still owns the returned DataUseRecorder*, right?

[Not at Google. Contact bengr, 2016/09/09 18:37:17]

Yes, that's why return type is DataUseRecorder* rather than unique_ptr.

+      const net::URLRequest* request) = 0;
+};
+
+}  // namespace data_use_measurement
+
+#endif  // COMPONENTS_DATA_USE_MEASUREMENT_CORE_DATA_USE_ASCRIBER_H_