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..a4d6300731a5fcb2c2a6acdf23cbb95c90437042
--- /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 embedder
+// 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(
+      const net::URLRequest* request) = 0;
+};
+
+}  // namespace data_use_measurement
+
+#endif  // COMPONENTS_DATA_USE_MEASUREMENT_CORE_DATA_USE_ASCRIBER_H_