blob: 495fef4114d0f6104e708b5215ef17898d7a8172 (
plain)
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
|
// Copyright 2013 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 CHROME_BROWSER_COMPONENT_UPDATER_UPDATE_RESPONSE_H_
#define CHROME_BROWSER_COMPONENT_UPDATER_UPDATE_RESPONSE_H_
#include <string>
#include <vector>
#include "base/basictypes.h"
#include "url/gurl.h"
namespace component_updater {
// Parses responses for the update protocol version 3.
// (http://code.google.com/p/omaha/wiki/ServerProtocol)
//
// An update response looks like this:
//
// <?xml version="1.0" encoding="UTF-8"?>
// <response protocol="3.0" server="prod">
// <daystart elapsed_seconds="56508"/>
// <app appid="{430FD4D0-B729-4F61-AA34-91526481799D}" status="ok">
// <updatecheck status="noupdate"/>
// <ping status="ok"/>
// </app>
// <app appid="{D0AB2EBC-931B-4013-9FEB-C9C4C2225C8C}" status="ok">
// <updatecheck status="ok">
// <urls>
// <url codebase="http://host/edgedl/chrome/install/782.112/"
// <url codebasediff="http://fallback/chrome/diff/782.112/"/>
// </urls>
// <manifest version="13.0.782.112" prodversionmin="2.0.143.0">
// <packages>
// <package name="component.crx"
// namediff="diff_1.2.3.4.crx"
// fp="1.123"
// hash_sha256="9830b4245c4..." size="23963192"
// hashdiff_sha256="cfb6caf3d0..." sizediff="101"/>
// </packages>
// </manifest>
// </updatecheck>
// <ping status="ok"/>
// </app>
// </response>
//
// The <daystart> tag contains a "elapsed_seconds" attribute which refers to
// the server's notion of how many seconds it has been since midnight.
//
// The "appid" attribute of the <app> tag refers to the unique id of the
// extension. The "codebase" attribute of the <updatecheck> tag is the url to
// fetch the updated crx file, and the "prodversionmin" attribute refers to
// the minimum version of the chrome browser that the update applies to.
//
// The diff data members correspond to the differential update package, if
// a differential update is specified in the response.
class UpdateResponse {
public:
// The result of parsing one <app> tag in an xml update check response.
struct Result {
struct Manifest {
struct Package {
Package();
~Package();
std::string fingerprint;
// Attributes for the full update.
std::string name;
std::string hash_sha256;
int size;
// Attributes for the differential update.
std::string namediff;
std::string hashdiff_sha256;
int sizediff;
};
Manifest();
~Manifest();
std::string version;
std::string browser_min_version;
std::vector<Package> packages;
};
Result();
~Result();
std::string extension_id;
// The list of fallback urls, for full and diff updates respectively.
std::vector<GURL> crx_urls;
std::vector<GURL> crx_diffurls;
Manifest manifest;
};
static const int kNoDaystart = -1;
struct Results {
Results();
~Results();
// This will be >= 0, or kNoDaystart if the <daystart> tag was not present.
int daystart_elapsed_seconds;
std::vector<Result> list;
};
UpdateResponse();
~UpdateResponse();
// Parses an update response xml string into Result data. Returns a bool
// indicating success or failure. On success, the results are available by
// calling results(). The details for any failures are available by calling
// errors().
bool Parse(const std::string& manifest_xml);
const Results& results() const { return results_; }
const std::string& errors() const { return errors_; }
private:
Results results_;
std::string errors_;
// Adds parse error details to |errors_| string.
void ParseError(const char* details, ...);
DISALLOW_COPY_AND_ASSIGN(UpdateResponse);
};
} // namespace component_updater
#endif // CHROME_BROWSER_COMPONENT_UPDATER_UPDATE_RESPONSE_H_
|
