OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 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 | 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_UPDATE_CLIENT_CRX_UPDATE_ITEM_H_ | 5 #ifndef COMPONENTS_UPDATE_CLIENT_CRX_UPDATE_ITEM_H_ |
6 #define COMPONENTS_UPDATE_CLIENT_CRX_UPDATE_ITEM_H_ | 6 #define COMPONENTS_UPDATE_CLIENT_CRX_UPDATE_ITEM_H_ |
7 | 7 |
8 #include <map> | 8 #include <map> |
9 #include <memory> | 9 #include <memory> |
10 #include <string> | 10 #include <string> |
11 #include <vector> | 11 #include <vector> |
12 | 12 |
13 #include "base/memory/weak_ptr.h" | 13 #include "base/memory/weak_ptr.h" |
14 #include "base/time/time.h" | 14 #include "base/time/time.h" |
15 #include "base/version.h" | 15 #include "base/version.h" |
16 #include "components/update_client/crx_downloader.h" | 16 #include "components/update_client/crx_downloader.h" |
17 #include "components/update_client/update_client.h" | 17 #include "components/update_client/update_client.h" |
18 | 18 |
19 namespace update_client { | 19 namespace update_client { |
20 | 20 |
21 // This is the one and only per-item state structure. Designed to be hosted | |
22 // in a std::vector or a std::list. The two main members are |component| | |
23 // which is supplied by the the component updater client and |status| which | |
24 // is modified as the item is processed by the update pipeline. The expected | |
25 // transition graph is: | |
26 // | |
27 // on-demand on-demand | |
28 // +---------------------------> kNew <--------------+-------------+ | |
29 // | | | | | |
30 // | V | | | |
31 // | +--------------------> kChecking -<-------+---|---<-----+ | | |
32 // | | | | | | | | |
33 // | | error V no | | | | | |
34 // kNoUpdate <---------------- [update?] ->---- kUpToDate kUpdated | |
35 // ^ | ^ | |
36 // | yes | | | |
37 // | diff=false V | | |
38 // | +-----------> kCanUpdate | | |
39 // | | | | | |
40 // | | V no | | |
41 // | | [differential update?]->----+ | | |
42 // | | | | | | |
43 // | | yes | | | | |
44 // | | error V | | | |
45 // | +---------<- kDownloadingDiff | | | |
46 // | | | | | | |
47 // | | | | | | |
48 // | | error V | | | |
49 // | +---------<- kUpdatingDiff ->--------|-----------+ success | |
50 // | | | | |
51 // | error V | | |
52 // +----------------------------------------- kDownloading | | |
53 // | | | | |
54 // | error V | | |
55 // +------------------------------------------ kUpdating ->----+ success | |
56 // | |
57 // TODO(sorin): this data structure will be further refactored once | |
58 // the new update service is in place. For the time being, it remains as-is, | |
59 // since it is used by the old component update service. | |
60 struct CrxUpdateItem { | 21 struct CrxUpdateItem { |
61 enum class State { | 22 CrxUpdateItem(); |
62 kNew, | 23 CrxUpdateItem(const CrxUpdateItem& other); |
63 kChecking, | 24 ~CrxUpdateItem(); |
64 kCanUpdate, | |
65 kDownloadingDiff, | |
66 kDownloading, | |
67 kDownloaded, | |
68 kUpdatingDiff, | |
69 kUpdating, | |
70 kUpdated, | |
71 kUpToDate, | |
72 kNoUpdate, | |
73 kUninstalled, | |
74 kLastStatus | |
75 }; | |
76 | 25 |
77 // Call CrxUpdateService::ChangeItemState to change |status|. The function may | 26 ComponentState state; |
78 // enforce conditions or notify observers of the change. | |
79 State state; | |
80 | 27 |
81 std::string id; | 28 std::string id; |
82 CrxComponent component; | 29 CrxComponent component; |
83 | 30 |
84 // Time when an update check for this CRX has happened. | 31 // Time when an update check for this CRX has happened. |
85 base::TimeTicks last_check; | 32 base::TimeTicks last_check; |
86 | 33 |
87 // Time when the update of this CRX has begun. | |
88 base::TimeTicks update_begin; | |
89 | |
90 // A component can be made available for download from several urls. | |
91 std::vector<GURL> crx_urls; | |
92 std::vector<GURL> crx_diffurls; | |
93 | |
94 // The cryptographic hash values for the component payload. | |
95 std::string hash_sha256; | |
96 std::string hashdiff_sha256; | |
97 | |
98 // The from/to version and fingerprint values. | |
99 base::Version previous_version; | |
100 base::Version next_version; | 34 base::Version next_version; |
101 std::string previous_fp; | |
102 std::string next_fp; | 35 std::string next_fp; |
103 | |
104 // True if the current update check cycle is on-demand. | |
105 bool on_demand; | |
106 | |
107 // True if the differential update failed for any reason. | |
108 bool diff_update_failed; | |
109 | |
110 // The error information for full and differential updates. | |
111 // The |error_category| contains a hint about which module in the component | |
112 // updater generated the error. The |error_code| constains the error and | |
113 // the |extra_code1| usually contains a system error, but it can contain | |
114 // any extended information that is relevant to either the category or the | |
115 // error itself. | |
116 int error_category; | |
117 int error_code; | |
118 int extra_code1; | |
119 int diff_error_category; | |
120 int diff_error_code; | |
121 int diff_extra_code1; | |
122 | |
123 std::vector<CrxDownloader::DownloadMetrics> download_metrics; | |
124 | |
125 CrxUpdateItem(); | |
126 CrxUpdateItem(const CrxUpdateItem& other); | |
127 ~CrxUpdateItem(); | |
128 | |
129 // Function object used to find a specific component. | |
130 class FindById { | |
131 public: | |
132 explicit FindById(const std::string& id) : id_(id) {} | |
133 | |
134 bool operator()(CrxUpdateItem* item) const { return item->id == id_; } | |
135 | |
136 private: | |
137 const std::string& id_; | |
138 }; | |
139 }; | 36 }; |
140 | 37 |
141 using IdToCrxUpdateItemMap = | |
142 std::map<std::string, std::unique_ptr<CrxUpdateItem>>; | |
143 | |
144 } // namespace update_client | 38 } // namespace update_client |
145 | 39 |
146 #endif // COMPONENTS_UPDATE_CLIENT_CRX_UPDATE_ITEM_H_ | 40 #endif // COMPONENTS_UPDATE_CLIENT_CRX_UPDATE_ITEM_H_ |
OLD | NEW |