1 // Copyright 2014 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef EXTENSIONS_BROWSER_UPDATER_MANIFEST_FETCH_DATA_H_
6 #define EXTENSIONS_BROWSER_UPDATER_MANIFEST_FETCH_DATA_H_
12 #include "base/basictypes.h"
15 namespace extensions {
17 // To save on server resources we can request updates for multiple extensions
18 // in one manifest check. This class helps us keep track of the id's for a
19 // given fetch, building up the actual URL, and what if anything to include
20 // in the ping parameter.
21 class ManifestFetchData {
23 static const int kNeverPinged = -1;
25 // What ping mode this fetch should use.
27 // No ping, no extra metrics.
30 // Ping without extra metrics.
33 // Ping with extra metrics.
37 // Each ping type is sent at most once per day.
39 // Used for counting total installs of an extension/app/theme.
42 // Used for counting number of active users of an app, where "active" means
43 // the app was launched at least once since the last active ping.
48 // The number of days it's been since our last rollcall or active ping,
49 // respectively. These are calculated based on the start of day from the
50 // server's perspective.
53 // Wether the extension is enabled or not.
56 PingData() : rollcall_days(0), active_days(0), is_enabled(true) {}
57 PingData(int rollcall, int active, bool enabled)
58 : rollcall_days(rollcall), active_days(active), is_enabled(enabled) {}
61 ManifestFetchData(const GURL& update_url,
63 const std::string& brand_code,
64 const std::string& base_query_params,
68 // Returns true if this extension information was successfully added. If the
69 // return value is false it means the full_url would have become too long, and
70 // this ManifestFetchData object remains unchanged.
71 bool AddExtension(const std::string& id,
72 const std::string& version,
73 const PingData* ping_data,
74 const std::string& update_url_data,
75 const std::string& install_source,
78 const GURL& base_url() const { return base_url_; }
79 const GURL& full_url() const { return full_url_; }
80 const std::set<std::string>& extension_ids() const { return extension_ids_; }
81 const std::set<int>& request_ids() const { return request_ids_; }
83 // Returns true if the given id is included in this manifest fetch.
84 bool Includes(const std::string& extension_id) const;
86 // Returns true if a ping parameter for |type| was added to full_url for this
88 bool DidPing(const std::string& extension_id, PingType type) const;
90 // Assuming that both this ManifestFetchData and |other| have the same
91 // full_url, this method merges the other information associated with the
92 // fetch (in particular this adds all request ids associated with |other|
93 // to this ManifestFetchData).
94 void Merge(const ManifestFetchData& other);
96 // Returns |true| if a given extension was forced to update.
97 bool DidForceUpdate(const std::string& extension_id) const;
100 // The set of extension id's for this ManifestFetchData.
101 std::set<std::string> extension_ids_;
103 // The set of ping data we actually sent.
104 std::map<std::string, PingData> pings_;
106 // The base update url without any arguments added.
109 // The base update url plus arguments indicating the id, version, etc.
110 // information about each extension.
113 // The set of request ids associated with this manifest fetch. If multiple
114 // requests are trying to fetch the same manifest, they can be merged into
115 // one fetch, so potentially multiple request ids can get associated with
116 // one ManifestFetchData.
117 std::set<int> request_ids_;
119 // The brand code to include with manifest fetch queries, if non-empty and
120 // |ping_mode_| >= PING.
121 const std::string brand_code_;
123 // The ping mode for this fetch. This determines whether or not ping data
124 // (and possibly extra metrics) will be included in the fetch query.
125 const PingMode ping_mode_;
127 // The set of extension IDs for which this fetch forced a CRX update.
128 std::set<std::string> forced_updates_;
130 DISALLOW_COPY_AND_ASSIGN(ManifestFetchData);
133 } // namespace extensions
135 #endif // EXTENSIONS_BROWSER_UPDATER_MANIFEST_FETCH_DATA_H_