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