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
|
// 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 <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,
kLastStatus
};
// Call CrxUpdateService::ChangeItemState to change |status|. The function may
// enforce conditions or notify observers of the change.
State state;
// True if the component was recently unregistered and will be uninstalled
// soon (after the currently operation is finished, if there is one).
bool unregistered;
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 update_client
#endif // COMPONENTS_UPDATE_CLIENT_CRX_UPDATE_ITEM_H_
|
