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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
// Copyright (c) 2012 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 CONTENT_PUBLIC_BROWSER_DOWNLOAD_URL_PARAMETERS_H_
#define CONTENT_PUBLIC_BROWSER_DOWNLOAD_URL_PARAMETERS_H_
#include <string>
#include <vector>
#include "base/basictypes.h"
#include "base/callback.h"
#include "content/public/browser/download_interrupt_reasons.h"
#include "content/public/browser/download_save_info.h"
#include "content/public/common/referrer.h"
#include "url/gurl.h"
namespace content {
class DownloadItem;
class ResourceContext;
class ResourceDispatcherHost;
class WebContents;
// Pass an instance of DownloadUrlParameters to DownloadManager::DownloadUrl()
// to download the content at |url|. All parameters with setters are optional.
// |referrer| and |referrer_encoding| are the referrer for the download. If
// |prefer_cache| is true, then if the response to |url| is in the HTTP cache it
// will be used without revalidation. If |post_id| is non-negative, then it
// identifies the post transaction used to originally retrieve the |url|
// resource - it also requires |prefer_cache| to be |true| since re-post'ing is
// not done. |save_info| specifies where the downloaded file should be saved,
// and whether the user should be prompted about the download. If not null,
// |callback| will be called when the download starts, or if an error occurs
// that prevents a download item from being created. We send a pointer to
// content::ResourceContext instead of the usual reference so that a copy of the
// object isn't made.
class CONTENT_EXPORT DownloadUrlParameters {
public:
// If there is an error, then |item| will be nullptr.
typedef base::Callback<void(DownloadItem*, DownloadInterruptReason)>
OnStartedCallback;
typedef std::pair<std::string, std::string> RequestHeadersNameValuePair;
typedef std::vector<RequestHeadersNameValuePair> RequestHeadersType;
static DownloadUrlParameters* FromWebContents(
WebContents* web_contents,
const GURL& url);
DownloadUrlParameters(
const GURL& url,
int render_process_host_id,
int render_view_host_routing_id,
content::ResourceContext* resource_context);
~DownloadUrlParameters();
void set_content_initiated(bool content_initiated) {
content_initiated_ = content_initiated;
}
void add_request_header(const std::string& name, const std::string& value) {
request_headers_.push_back(make_pair(name, value));
}
void set_referrer(const Referrer& referrer) { referrer_ = referrer; }
void set_referrer_encoding(const std::string& referrer_encoding) {
referrer_encoding_ = referrer_encoding;
}
void set_last_modified(const std::string& last_modified) {
last_modified_ = last_modified;
}
void set_etag(const std::string& etag) {
etag_ = etag;
}
void set_method(const std::string& method) {
method_ = method;
}
void set_post_body(const std::string& post_body) {
post_body_ = post_body;
}
void set_prefer_cache(bool prefer_cache) {
prefer_cache_ = prefer_cache;
}
void set_post_id(int64 post_id) { post_id_ = post_id; }
void set_callback(const OnStartedCallback& callback) {
callback_ = callback;
}
void set_file_path(const base::FilePath& file_path) {
save_info_.file_path = file_path;
}
void set_suggested_name(const base::string16& suggested_name) {
save_info_.suggested_name = suggested_name;
}
void set_offset(int64 offset) { save_info_.offset = offset; }
void set_hash_state(std::string hash_state) {
save_info_.hash_state = hash_state;
}
void set_prompt(bool prompt) { save_info_.prompt_for_save_location = prompt; }
void set_file(base::File file) {
save_info_.file = file.Pass();
}
void set_do_not_prompt_for_login(bool do_not_prompt) {
do_not_prompt_for_login_ = do_not_prompt;
}
const OnStartedCallback& callback() const { return callback_; }
bool content_initiated() const { return content_initiated_; }
const std::string& last_modified() const { return last_modified_; }
const std::string& etag() const { return etag_; }
const std::string& method() const { return method_; }
const std::string& post_body() const { return post_body_; }
int64 post_id() const { return post_id_; }
bool prefer_cache() const { return prefer_cache_; }
const Referrer& referrer() const { return referrer_; }
const std::string& referrer_encoding() const { return referrer_encoding_; }
int render_process_host_id() const { return render_process_host_id_; }
int render_view_host_routing_id() const {
return render_view_host_routing_id_;
}
RequestHeadersType::const_iterator request_headers_begin() const {
return request_headers_.begin();
}
RequestHeadersType::const_iterator request_headers_end() const {
return request_headers_.end();
}
content::ResourceContext* resource_context() const {
return resource_context_;
}
const base::FilePath& file_path() const { return save_info_.file_path; }
const base::string16& suggested_name() const {
return save_info_.suggested_name;
}
int64 offset() const { return save_info_.offset; }
const std::string& hash_state() const { return save_info_.hash_state; }
bool prompt() const { return save_info_.prompt_for_save_location; }
const GURL& url() const { return url_; }
bool do_not_prompt_for_login() const { return do_not_prompt_for_login_; }
// Note that this is state changing--the DownloadUrlParameters object
// will not have a file attached to it after this call.
base::File GetFile() { return save_info_.file.Pass(); }
private:
OnStartedCallback callback_;
bool content_initiated_;
RequestHeadersType request_headers_;
std::string last_modified_;
std::string etag_;
std::string method_;
std::string post_body_;
int64 post_id_;
bool prefer_cache_;
Referrer referrer_;
std::string referrer_encoding_;
int render_process_host_id_;
int render_view_host_routing_id_;
ResourceContext* resource_context_;
DownloadSaveInfo save_info_;
GURL url_;
bool do_not_prompt_for_login_;
DISALLOW_COPY_AND_ASSIGN(DownloadUrlParameters);
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_DOWNLOAD_URL_PARAMETERS_H_
|
