| OLD | NEW |
| 1 // Copyright 2016 The Chromium Authors. All rights reserved. | 1 // Copyright 2016 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef COMPONENTS_NTP_SNIPPETS_REQUEST_THROTTLER_H_ | 5 #ifndef COMPONENTS_NTP_SNIPPETS_REQUEST_THROTTLER_H_ |
| 6 #define COMPONENTS_NTP_SNIPPETS_REQUEST_THROTTLER_H_ | 6 #define COMPONENTS_NTP_SNIPPETS_REQUEST_THROTTLER_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 | 9 |
| 10 #include "base/macros.h" | 10 #include "base/macros.h" |
| 11 | 11 |
| 12 class PrefRegistrySimple; | 12 class PrefRegistrySimple; |
| 13 class PrefService; | 13 class PrefService; |
| 14 | 14 |
| 15 namespace base { | 15 namespace base { |
| 16 class HistogramBase; | 16 class HistogramBase; |
| 17 } // namespace base | 17 } // namespace base |
| 18 | 18 |
| 19 namespace ntp_snippets { | 19 namespace ntp_snippets { |
| 20 | 20 |
| 21 struct RequestTypeInfo; | |
| 22 | |
| 23 // Counts requests to external services, compares them to a daily quota, reports | 21 // Counts requests to external services, compares them to a daily quota, reports |
| 24 // them to UMA. In the application code, create one local instance for each type | 22 // them to UMA. In the application code, create one local instance for each type |
| 25 // of requests, identified by the RequestType. The request counter is based on: | 23 // of requests, identified by the RequestType. The request counter is based on: |
| 26 // - daily quota from a variation param "quota_|type|" in the NTPSnippets trial | 24 // - daily quota from a variation param "quota_|type|" in the NTPSnippets trial |
| 27 // - pref "ntp.request_throttler.|type|.count" to store the current counter, | 25 // - pref "ntp.request_throttler.|type|.count" to store the current counter, |
| 28 // - pref "ntp.request_throttler.|type|.day" to store current day to which the | 26 // - pref "ntp.request_throttler.|type|.day" to store current day to which the |
| 29 // current counter value applies. | 27 // current counter value applies. |
| 30 // Furthermore the counter reports to histograms: | 28 // Furthermore the counter reports to histograms: |
| 31 // - "NewTabPage.RequestThrottler.RequestStatus_|type|" - status of each | 29 // - "NewTabPage.RequestThrottler.RequestStatus_|type|" - status of each |
| 32 // request; | 30 // request; |
| 33 // - "NewTabPage.RequestThrottler.PerDay_|type|" - the daily count of requests. | 31 // - "NewTabPage.RequestThrottler.PerDay_|type|" - the daily count of requests. |
| 34 // | 32 // |
| 35 // Implementation notes: When extending this class for a new RequestType, please | 33 // Implementation notes: When extending this class for a new RequestType, please |
| 36 // 1) define in request_counter.cc in kRequestTypeInfo | 34 // 1) define in request_counter.cc in kRequestTypeInfo |
| 37 // a) the string value for your |type| and | 35 // a) the string value for your |type| and |
| 38 // b) constants for day/count prefs; | 36 // b) constants for day/count prefs; |
| 39 // 2) define a new RequestThrottlerTypes histogram suffix in histogram.xml | 37 // 2) define a new RequestThrottlerTypes histogram suffix in histogram.xml |
| 40 // (with the same string value as in 1a)). | 38 // (with the same string value as in 1a)). |
| 41 class RequestThrottler { | 39 class RequestThrottler { |
| 42 public: | 40 public: |
| 43 // Enumeration listing all current applications of the request counter. | 41 // Enumeration listing all current applications of the request counter. |
| 44 enum class RequestType { | 42 enum class RequestType { |
| 45 CONTENT_SUGGESTION_FETCHER | 43 CONTENT_SUGGESTION_FETCHER |
| 46 }; | 44 }; |
| 47 | 45 |
| 48 RequestThrottler(PrefService* pref_service, | 46 RequestThrottler(PrefService* pref_service, RequestType type); |
| 49 RequestType type, | |
| 50 int default_quota); | |
| 51 | 47 |
| 52 // Registers profile prefs for all RequestTypes. Called from browser_prefs.cc. | 48 // Registers profile prefs for all RequestTypes. Called from browser_prefs.cc. |
| 53 static void RegisterProfilePrefs(PrefRegistrySimple* registry); | 49 static void RegisterProfilePrefs(PrefRegistrySimple* registry); |
| 54 | 50 |
| 55 // Returns whether quota is available for another request and reports this | 51 // Returns whether quota is available for another request and reports this |
| 56 // information to UMA. Forced requests always return true -- should be only | 52 // information to UMA. Forced requests always return true -- should be only |
| 57 // used for requests initiated by the user (if it is safe to assume that all | 53 // used for requests initiated by the user (if it is safe to assume that all |
| 58 // users cannot generate an amount of requests we cannot handle). | 54 // users cannot generate an amount of requests we cannot handle). |
| 59 bool DemandQuotaForRequest(bool force_request); | 55 bool DemandQuotaForRequest(bool force_request); |
| 60 | 56 |
| 61 private: | 57 private: |
| 58 friend class RequestThrottlerTest; |
| 59 // Used internally for working with a RequestType. |
| 60 struct RequestTypeInfo; |
| 61 |
| 62 // The array of info entries - one per each RequestType. |
| 63 static const RequestTypeInfo kRequestTypeInfo[]; |
| 64 |
| 62 // Also emits the PerDay histogram if the day changed. | 65 // Also emits the PerDay histogram if the day changed. |
| 63 void ResetCounterIfDayChanged(); | 66 void ResetCounterIfDayChanged(); |
| 64 | 67 |
| 65 const char* GetRequestTypeAsString() const; | 68 const char* GetRequestTypeAsString() const; |
| 66 | 69 |
| 67 int GetCount() const; | 70 int GetCount() const; |
| 68 void SetCount(int count); | 71 void SetCount(int count); |
| 69 int GetDay() const; | 72 int GetDay() const; |
| 70 void SetDay(int day); | 73 void SetDay(int day); |
| 71 bool HasDay() const; | 74 bool HasDay() const; |
| 72 | 75 |
| 73 PrefService* pref_service_; | 76 PrefService* pref_service_; |
| 74 const RequestTypeInfo& type_info_; | 77 const RequestTypeInfo& type_info_; |
| 75 | 78 |
| 76 // It comes from a variation parameter or |default_quota| as a fallback. | 79 // It comes from a variation parameter or |default_quota| as a fallback. |
| 77 int quota_; | 80 int quota_; |
| 78 | 81 |
| 79 // The histograms for reporting the requests of the given |type_|. | 82 // The histograms for reporting the requests of the given |type_|. |
| 80 base::HistogramBase* histogram_request_status_; | 83 base::HistogramBase* histogram_request_status_; |
| 81 base::HistogramBase* histogram_per_day_; | 84 base::HistogramBase* histogram_per_day_; |
| 82 | 85 |
| 83 DISALLOW_COPY_AND_ASSIGN(RequestThrottler); | 86 DISALLOW_COPY_AND_ASSIGN(RequestThrottler); |
| 84 }; | 87 }; |
| 85 | 88 |
| 86 } // namespace ntp_snippets | 89 } // namespace ntp_snippets |
| 87 | 90 |
| 88 #endif // COMPONENTS_NTP_SNIPPETS_REQUEST_THROTTLER_H_ | 91 #endif // COMPONENTS_NTP_SNIPPETS_REQUEST_THROTTLER_H_ |
| OLD | NEW |