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
|
// 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_COMPONENT_UPDATER_CRX_UPDATE_ITEM_H_
#define COMPONENTS_COMPONENT_UPDATER_CRX_UPDATE_ITEM_H_
#include <string>
#include <vector>
#include "base/memory/weak_ptr.h"
#include "base/time/time.h"
#include "base/version.h"
#include "components/component_updater/component_updater_service.h"
#include "components/component_updater/crx_downloader.h"
namespace component_updater {
// 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
//
struct CrxUpdateItem {
enum Status {
kNew,
kChecking,
kCanUpdate,
kDownloadingDiff,
kDownloading,
kUpdatingDiff,
kUpdating,
kUpdated,
kUpToDate,
kNoUpdate,
kLastStatus
};
// Call CrxUpdateService::ChangeItemState to change |status|. The function may
// enforce conditions or notify observers of the change.
Status status;
std::string id;
CrxComponent component;
base::Time last_check;
// A component can be made available for download from several urls.
std::vector<GURL> crx_urls;
std::vector<GURL> crx_diffurls;
// The from/to version and fingerprint values.
Version previous_version;
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;
std::vector<base::Closure> ready_callbacks;
CrxUpdateItem();
~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_;
};
};
} // namespace component_updater
#endif // COMPONENTS_COMPONENT_UPDATER_CRX_UPDATE_ITEM_H_
|
