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