File: ResourceRequest.h

package info (click to toggle)
chromium-browser 57.0.2987.98-1~deb8u1
  • links: PTS, VCS
  • area: main
  • in suites: jessie
  • size: 2,637,852 kB
  • ctags: 2,544,394
  • sloc: cpp: 12,815,961; ansic: 3,676,222; python: 1,147,112; asm: 526,608; java: 523,212; xml: 286,794; perl: 92,654; sh: 86,408; objc: 73,271; makefile: 27,698; cs: 18,487; yacc: 13,031; tcl: 12,957; pascal: 4,875; ml: 4,716; lex: 3,904; sql: 3,862; ruby: 1,982; lisp: 1,508; php: 1,368; exp: 404; awk: 325; csh: 117; jsp: 39; sed: 37
file content (410 lines) | stat: -rw-r--r-- 14,314 bytes parent folder | download
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
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
/*
 * Copyright (C) 2003, 2006 Apple Computer, Inc.  All rights reserved.
 * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
 * Copyright (C) 2009, 2012 Google Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef ResourceRequest_h
#define ResourceRequest_h

#include "platform/HTTPNames.h"
#include "platform/network/EncodedFormData.h"
#include "platform/network/HTTPHeaderMap.h"
#include "platform/network/HTTPParsers.h"
#include "platform/network/ResourceLoadPriority.h"
#include "platform/weborigin/KURL.h"
#include "platform/weborigin/Referrer.h"
#include "platform/weborigin/SecurityOrigin.h"
#include "public/platform/WebAddressSpace.h"
#include "public/platform/WebURLRequest.h"
#include "wtf/RefCounted.h"
#include <memory>

namespace blink {

enum class WebCachePolicy;

enum class ResourceRequestBlockedReason {
  CSP,
  MixedContent,
  Origin,
  Inspector,
  SubresourceFilter,
  Other,
  None
};

enum InputToLoadPerfMetricReportPolicy {
  NoReport,    // Don't report metrics for this ResourceRequest.
  ReportLink,  // Report metrics for this request as initiated by a link click.
  ReportIntent,  // Report metrics for this request as initiated by an intent.
};

struct CrossThreadResourceRequestData;

class PLATFORM_EXPORT ResourceRequest final {
  DISALLOW_NEW();

 public:
  enum class RedirectStatus { FollowedRedirect, NoRedirect };

  class ExtraData : public RefCounted<ExtraData> {
   public:
    virtual ~ExtraData() {}
  };

  ResourceRequest();
  ResourceRequest(const String& urlString);
  ResourceRequest(const KURL&);
  explicit ResourceRequest(CrossThreadResourceRequestData*);
  ResourceRequest(const ResourceRequest&);
  ResourceRequest& operator=(const ResourceRequest&);

  // Gets a copy of the data suitable for passing to another thread.
  std::unique_ptr<CrossThreadResourceRequestData> copyData() const;

  bool isNull() const;
  bool isEmpty() const;

  const KURL& url() const;
  void setURL(const KURL& url);

  void removeCredentials();

  WebCachePolicy getCachePolicy() const;
  void setCachePolicy(WebCachePolicy);

  double timeoutInterval() const;  // May return 0 when using platform default.
  void setTimeoutInterval(double);

  const KURL& firstPartyForCookies() const;
  void setFirstPartyForCookies(const KURL& firstPartyForCookies);

  PassRefPtr<SecurityOrigin> requestorOrigin() const;
  void setRequestorOrigin(PassRefPtr<SecurityOrigin>);

  const AtomicString& httpMethod() const;
  void setHTTPMethod(const AtomicString&);

  const HTTPHeaderMap& httpHeaderFields() const;
  const AtomicString& httpHeaderField(const AtomicString& name) const;
  void setHTTPHeaderField(const AtomicString& name, const AtomicString& value);
  void addHTTPHeaderField(const AtomicString& name, const AtomicString& value);
  void addHTTPHeaderFields(const HTTPHeaderMap& headerFields);
  void clearHTTPHeaderField(const AtomicString& name);

  const AtomicString& httpContentType() const {
    return httpHeaderField(HTTPNames::Content_Type);
  }
  void setHTTPContentType(const AtomicString& httpContentType) {
    setHTTPHeaderField(HTTPNames::Content_Type, httpContentType);
  }

  bool didSetHTTPReferrer() const { return m_didSetHTTPReferrer; }
  const AtomicString& httpReferrer() const {
    return httpHeaderField(HTTPNames::Referer);
  }
  ReferrerPolicy getReferrerPolicy() const { return m_referrerPolicy; }
  void setHTTPReferrer(const Referrer&);
  void clearHTTPReferrer();

  const AtomicString& httpOrigin() const {
    return httpHeaderField(HTTPNames::Origin);
  }
  const AtomicString& httpSuborigin() const {
    return httpHeaderField(HTTPNames::Suborigin);
  }
  // Note that these will also set and clear, respectively, the
  // Suborigin header, if appropriate.
  void setHTTPOrigin(const SecurityOrigin*);
  void clearHTTPOrigin();

  void addHTTPOriginIfNeeded(const SecurityOrigin*);
  void addHTTPOriginIfNeeded(const String&);

  const AtomicString& httpUserAgent() const {
    return httpHeaderField(HTTPNames::User_Agent);
  }
  void setHTTPUserAgent(const AtomicString& httpUserAgent) {
    setHTTPHeaderField(HTTPNames::User_Agent, httpUserAgent);
  }
  void clearHTTPUserAgent();

  void setHTTPAccept(const AtomicString& httpAccept) {
    setHTTPHeaderField(HTTPNames::Accept, httpAccept);
  }

  EncodedFormData* httpBody() const;
  void setHTTPBody(PassRefPtr<EncodedFormData>);

  EncodedFormData* attachedCredential() const;
  void setAttachedCredential(PassRefPtr<EncodedFormData>);

  bool allowStoredCredentials() const;
  void setAllowStoredCredentials(bool allowCredentials);

  ResourceLoadPriority priority() const;
  void setPriority(ResourceLoadPriority, int intraPriorityValue = 0);

  bool isConditional() const;

  // Whether the associated ResourceHandleClient needs to be notified of
  // upload progress made for that resource.
  bool reportUploadProgress() const { return m_reportUploadProgress; }
  void setReportUploadProgress(bool reportUploadProgress) {
    m_reportUploadProgress = reportUploadProgress;
  }

  // Whether actual headers being sent/received should be collected and reported
  // for the request.
  bool reportRawHeaders() const { return m_reportRawHeaders; }
  void setReportRawHeaders(bool reportRawHeaders) {
    m_reportRawHeaders = reportRawHeaders;
  }

  // Allows the request to be matched up with its requestor.
  int requestorID() const { return m_requestorID; }
  void setRequestorID(int requestorID) { m_requestorID = requestorID; }

  // The process id of the process from which this request originated. In
  // the case of out-of-process plugins, this allows to link back the
  // request to the plugin process (as it is processed through a render
  // view process).
  int requestorProcessID() const { return m_requestorProcessID; }
  void setRequestorProcessID(int requestorProcessID) {
    m_requestorProcessID = requestorProcessID;
  }

  // Allows the request to be matched up with its app cache host.
  int appCacheHostID() const { return m_appCacheHostID; }
  void setAppCacheHostID(int id) { m_appCacheHostID = id; }

  // True if request was user initiated.
  bool hasUserGesture() const { return m_hasUserGesture; }
  void setHasUserGesture(bool);

  // True if request should be downloaded to file.
  bool downloadToFile() const { return m_downloadToFile; }
  void setDownloadToFile(bool downloadToFile) {
    m_downloadToFile = downloadToFile;
  }

  // True if the requestor wants to receive a response body as
  // WebDataConsumerHandle.
  bool useStreamOnResponse() const { return m_useStreamOnResponse; }
  void setUseStreamOnResponse(bool useStreamOnResponse) {
    m_useStreamOnResponse = useStreamOnResponse;
  }

  // Indicates which types of ServiceWorkers should skip handling this request.
  WebURLRequest::SkipServiceWorker skipServiceWorker() const {
    return m_skipServiceWorker;
  }
  void setSkipServiceWorker(
      WebURLRequest::SkipServiceWorker skipServiceWorker) {
    m_skipServiceWorker = skipServiceWorker;
  }

  // True if corresponding AppCache group should be resetted.
  bool shouldResetAppCache() { return m_shouldResetAppCache; }
  void setShouldResetAppCache(bool shouldResetAppCache) {
    m_shouldResetAppCache = shouldResetAppCache;
  }

  // Extra data associated with this request.
  ExtraData* getExtraData() const { return m_extraData.get(); }
  void setExtraData(PassRefPtr<ExtraData> extraData) {
    m_extraData = extraData;
  }

  WebURLRequest::RequestContext requestContext() const {
    return m_requestContext;
  }
  void setRequestContext(WebURLRequest::RequestContext context) {
    m_requestContext = context;
  }

  WebURLRequest::FrameType frameType() const { return m_frameType; }
  void setFrameType(WebURLRequest::FrameType frameType) {
    m_frameType = frameType;
  }

  WebURLRequest::FetchRequestMode fetchRequestMode() const {
    return m_fetchRequestMode;
  }
  void setFetchRequestMode(WebURLRequest::FetchRequestMode mode) {
    m_fetchRequestMode = mode;
  }

  WebURLRequest::FetchCredentialsMode fetchCredentialsMode() const {
    return m_fetchCredentialsMode;
  }
  void setFetchCredentialsMode(WebURLRequest::FetchCredentialsMode mode) {
    m_fetchCredentialsMode = mode;
  }

  WebURLRequest::FetchRedirectMode fetchRedirectMode() const {
    return m_fetchRedirectMode;
  }
  void setFetchRedirectMode(WebURLRequest::FetchRedirectMode redirect) {
    m_fetchRedirectMode = redirect;
  }

  WebURLRequest::PreviewsState previewsState() const { return m_previewsState; }
  void setPreviewsState(WebURLRequest::PreviewsState previewsState) {
    m_previewsState = previewsState;
  }

  bool cacheControlContainsNoCache() const;
  bool cacheControlContainsNoStore() const;
  bool hasCacheValidatorFields() const;

  bool checkForBrowserSideNavigation() const {
    return m_checkForBrowserSideNavigation;
  }
  void setCheckForBrowserSideNavigation(bool check) {
    m_checkForBrowserSideNavigation = check;
  }

  double uiStartTime() const { return m_uiStartTime; }
  void setUIStartTime(double uiStartTimeSeconds) {
    m_uiStartTime = uiStartTimeSeconds;
  }

  // https://mikewest.github.io/cors-rfc1918/#external-request
  bool isExternalRequest() const { return m_isExternalRequest; }
  void setExternalRequestStateFromRequestorAddressSpace(WebAddressSpace);

  InputToLoadPerfMetricReportPolicy inputPerfMetricReportPolicy() const {
    return m_inputPerfMetricReportPolicy;
  }
  void setInputPerfMetricReportPolicy(
      InputToLoadPerfMetricReportPolicy inputPerfMetricReportPolicy) {
    m_inputPerfMetricReportPolicy = inputPerfMetricReportPolicy;
  }

  void setRedirectStatus(RedirectStatus status) { m_redirectStatus = status; }
  RedirectStatus redirectStatus() const { return m_redirectStatus; }

  void setNavigationStartTime(double);
  double navigationStartTime() const { return m_navigationStart; }

 private:
  const CacheControlHeader& cacheControlHeader() const;

  bool needsHTTPOrigin() const;

  KURL m_url;
  WebCachePolicy m_cachePolicy;
  double m_timeoutInterval;  // 0 is a magic value for platform default on
                             // platforms that have one.
  KURL m_firstPartyForCookies;
  RefPtr<SecurityOrigin> m_requestorOrigin;
  AtomicString m_httpMethod;
  HTTPHeaderMap m_httpHeaderFields;
  RefPtr<EncodedFormData> m_httpBody;
  RefPtr<EncodedFormData> m_attachedCredential;
  bool m_allowStoredCredentials : 1;
  bool m_reportUploadProgress : 1;
  bool m_reportRawHeaders : 1;
  bool m_hasUserGesture : 1;
  bool m_downloadToFile : 1;
  bool m_useStreamOnResponse : 1;
  bool m_shouldResetAppCache : 1;
  WebURLRequest::SkipServiceWorker m_skipServiceWorker;
  ResourceLoadPriority m_priority;
  int m_intraPriorityValue;
  int m_requestorID;
  int m_requestorProcessID;
  int m_appCacheHostID;
  RefPtr<ExtraData> m_extraData;
  WebURLRequest::RequestContext m_requestContext;
  WebURLRequest::FrameType m_frameType;
  WebURLRequest::FetchRequestMode m_fetchRequestMode;
  WebURLRequest::FetchCredentialsMode m_fetchCredentialsMode;
  WebURLRequest::FetchRedirectMode m_fetchRedirectMode;
  WebURLRequest::PreviewsState m_previewsState;
  ReferrerPolicy m_referrerPolicy;
  bool m_didSetHTTPReferrer;
  bool m_checkForBrowserSideNavigation;
  double m_uiStartTime;
  bool m_isExternalRequest;
  InputToLoadPerfMetricReportPolicy m_inputPerfMetricReportPolicy;

  mutable CacheControlHeader m_cacheControlHeaderCache;

  static double s_defaultTimeoutInterval;

  RedirectStatus m_redirectStatus;

  double m_navigationStart = 0;
};

struct CrossThreadResourceRequestData {
  WTF_MAKE_NONCOPYABLE(CrossThreadResourceRequestData);
  USING_FAST_MALLOC(CrossThreadResourceRequestData);

 public:
  CrossThreadResourceRequestData() {}
  KURL m_url;

  WebCachePolicy m_cachePolicy;
  double m_timeoutInterval;
  KURL m_firstPartyForCookies;
  RefPtr<SecurityOrigin> m_requestorOrigin;

  String m_httpMethod;
  std::unique_ptr<CrossThreadHTTPHeaderMapData> m_httpHeaders;
  RefPtr<EncodedFormData> m_httpBody;
  RefPtr<EncodedFormData> m_attachedCredential;
  bool m_allowStoredCredentials;
  bool m_reportUploadProgress;
  bool m_hasUserGesture;
  bool m_downloadToFile;
  WebURLRequest::SkipServiceWorker m_skipServiceWorker;
  bool m_useStreamOnResponse;
  bool m_shouldResetAppCache;
  ResourceLoadPriority m_priority;
  int m_intraPriorityValue;
  int m_requestorID;
  int m_requestorProcessID;
  int m_appCacheHostID;
  WebURLRequest::RequestContext m_requestContext;
  WebURLRequest::FrameType m_frameType;
  WebURLRequest::FetchRequestMode m_fetchRequestMode;
  WebURLRequest::FetchCredentialsMode m_fetchCredentialsMode;
  WebURLRequest::FetchRedirectMode m_fetchRedirectMode;
  WebURLRequest::PreviewsState m_previewsState;
  ReferrerPolicy m_referrerPolicy;
  bool m_didSetHTTPReferrer;
  bool m_checkForBrowserSideNavigation;
  double m_uiStartTime;
  bool m_isExternalRequest;
  InputToLoadPerfMetricReportPolicy m_inputPerfMetricReportPolicy;
  ResourceRequest::RedirectStatus m_redirectStatus;
};

}  // namespace blink

#endif  // ResourceRequest_h