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
|
/*
* Copyright (C) 2009 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:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * 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.
* * Neither the name of Google Inc. nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "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 THE COPYRIGHT
* OWNER 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 WebURLRequest_h
#define WebURLRequest_h
#include "WebCommon.h"
#include "WebHTTPBody.h"
#if defined(WEBKIT_IMPLEMENTATION)
namespace WebCore { class ResourceRequest; }
#endif
namespace WebKit {
class WebCString;
class WebHTTPBody;
class WebHTTPHeaderVisitor;
class WebString;
class WebURL;
class WebURLRequestPrivate;
class WebURLRequest {
public:
enum CachePolicy {
UseProtocolCachePolicy, // normal load
ReloadIgnoringCacheData, // reload
ReturnCacheDataElseLoad, // back/forward or encoding change - allow stale data
ReturnCacheDataDontLoad, // results of a post - allow stale data and only use cache
};
enum TargetType {
TargetIsMainFrame = 0,
TargetIsSubFrame = 1, // Temporary for backward compatibility.
TargetIsSubframe = 1,
TargetIsSubResource = 2, // Temporary for backward comptibility.
TargetIsSubresource = 2,
TargetIsStyleSheet = 3,
TargetIsScript = 4,
TargetIsFontResource = 5,
TargetIsImage = 6,
TargetIsObject = 7,
TargetIsMedia = 8,
TargetIsWorker = 9,
TargetIsSharedWorker = 10,
TargetIsPrefetch = 11,
};
~WebURLRequest() { reset(); }
WebURLRequest() : m_private(0) { }
WebURLRequest(const WebURLRequest& r) : m_private(0) { assign(r); }
WebURLRequest& operator=(const WebURLRequest& r)
{
assign(r);
return *this;
}
explicit WebURLRequest(const WebURL& url) : m_private(0)
{
initialize();
setURL(url);
}
WEBKIT_API void initialize();
WEBKIT_API void reset();
WEBKIT_API void assign(const WebURLRequest&);
WEBKIT_API bool isNull() const;
WEBKIT_API WebURL url() const;
WEBKIT_API void setURL(const WebURL&);
// Used to implement third-party cookie blocking.
WEBKIT_API WebURL firstPartyForCookies() const;
WEBKIT_API void setFirstPartyForCookies(const WebURL&);
WEBKIT_API bool allowCookies() const;
WEBKIT_API void setAllowCookies(bool allowCookies);
// Controls whether user name, password, and cookies may be sent with the
// request. (If false, this overrides allowCookies.)
WEBKIT_API bool allowStoredCredentials() const;
WEBKIT_API void setAllowStoredCredentials(bool allowStoredCredentials);
WEBKIT_API CachePolicy cachePolicy() const;
WEBKIT_API void setCachePolicy(CachePolicy);
WEBKIT_API WebString httpMethod() const;
WEBKIT_API void setHTTPMethod(const WebString&);
WEBKIT_API WebString httpHeaderField(const WebString& name) const;
WEBKIT_API void setHTTPHeaderField(const WebString& name, const WebString& value);
WEBKIT_API void addHTTPHeaderField(const WebString& name, const WebString& value);
WEBKIT_API void clearHTTPHeaderField(const WebString& name);
WEBKIT_API void visitHTTPHeaderFields(WebHTTPHeaderVisitor*) const;
WEBKIT_API WebHTTPBody httpBody() const;
WEBKIT_API void setHTTPBody(const WebHTTPBody&);
// Controls whether upload progress events are generated when a request
// has a body.
WEBKIT_API bool reportUploadProgress() const;
WEBKIT_API void setReportUploadProgress(bool);
// Controls whether load timing info is collected for the request.
WEBKIT_API bool reportLoadTiming() const;
WEBKIT_API void setReportLoadTiming(bool);
// Controls whether actual headers sent and received for request are
// collected and reported.
WEBKIT_API bool reportRawHeaders() const;
WEBKIT_API void setReportRawHeaders(bool);
WEBKIT_API TargetType targetType() const;
WEBKIT_API void setTargetType(TargetType);
// A consumer controlled value intended to be used to identify the
// requestor.
WEBKIT_API int requestorID() const;
WEBKIT_API void setRequestorID(int);
// A consumer controlled value intended to be used to identify the
// process of the requestor.
WEBKIT_API int requestorProcessID() const;
WEBKIT_API void setRequestorProcessID(int);
// Allows the request to be matched up with its app cache host.
WEBKIT_API int appCacheHostID() const;
WEBKIT_API void setAppCacheHostID(int id);
// If true, the response body will be downloaded to a file managed by the
// WebURLLoader. See WebURLResponse::downloadedFilePath.
WEBKIT_API bool downloadToFile() const;
WEBKIT_API void setDownloadToFile(bool);
#if defined(WEBKIT_IMPLEMENTATION)
WebCore::ResourceRequest& toMutableResourceRequest();
const WebCore::ResourceRequest& toResourceRequest() const;
#endif
protected:
void assign(WebURLRequestPrivate*);
private:
WebURLRequestPrivate* m_private;
};
} // namespace WebKit
#endif
|
