[iOS] Upstream WebCore/platform changes
[WebKit-https.git] / Source / WebCore / platform / network / ResourceRequestBase.h
1 /*
2  * Copyright (C) 2003, 2006 Apple Computer, Inc.  All rights reserved.
3  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
4  * Copyright (C) 2009, 2012 Google Inc. All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
16  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
19  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
20  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
21  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
22  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
23  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
26  */
27
28 #ifndef ResourceRequestBase_h
29 #define ResourceRequestBase_h
30
31 #include "FormData.h"
32 #include "HTTPHeaderMap.h"
33 #include "URL.h"
34 #include "ResourceLoadPriority.h"
35
36 #include <wtf/OwnPtr.h>
37
38 namespace WebCore {
39
40     enum ResourceRequestCachePolicy {
41         UseProtocolCachePolicy, // normal load
42         ReloadIgnoringCacheData, // reload
43         ReturnCacheDataElseLoad, // back/forward or encoding change - allow stale data
44         ReturnCacheDataDontLoad  // results of a post - allow stale data and only use cache
45     };
46
47     enum HTTPBodyUpdatePolicy {
48         DoNotUpdateHTTPBody,
49         UpdateHTTPBody
50     };
51
52     class ResourceRequest;
53     struct CrossThreadResourceRequestData;
54
55     // Do not use this type directly.  Use ResourceRequest instead.
56     class ResourceRequestBase {
57         WTF_MAKE_FAST_ALLOCATED;
58     public:
59         static PassOwnPtr<ResourceRequest> adopt(PassOwnPtr<CrossThreadResourceRequestData>);
60
61         // Gets a copy of the data suitable for passing to another thread.
62         PassOwnPtr<CrossThreadResourceRequestData> copyData() const;
63
64         bool isNull() const;
65         bool isEmpty() const;
66
67         const URL& url() const;
68         void setURL(const URL& url);
69
70         void removeCredentials();
71
72         ResourceRequestCachePolicy cachePolicy() const;
73         void setCachePolicy(ResourceRequestCachePolicy cachePolicy);
74         
75         double timeoutInterval() const; // May return 0 when using platform default.
76         void setTimeoutInterval(double timeoutInterval);
77         
78         const URL& firstPartyForCookies() const;
79         void setFirstPartyForCookies(const URL& firstPartyForCookies);
80         
81         const String& httpMethod() const;
82         void setHTTPMethod(const String& httpMethod);
83         
84         const HTTPHeaderMap& httpHeaderFields() const;
85         String httpHeaderField(const AtomicString& name) const;
86         String httpHeaderField(const char* name) const;
87         void setHTTPHeaderField(const AtomicString& name, const String& value);
88         void setHTTPHeaderField(const char* name, const String& value);
89         void addHTTPHeaderField(const AtomicString& name, const String& value);
90         void addHTTPHeaderFields(const HTTPHeaderMap& headerFields);
91         
92         void clearHTTPAuthorization();
93
94         String httpContentType() const { return httpHeaderField("Content-Type");  }
95         void setHTTPContentType(const String& httpContentType) { setHTTPHeaderField("Content-Type", httpContentType); }
96         void clearHTTPContentType();
97
98         String httpReferrer() const { return httpHeaderField("Referer"); }
99         void setHTTPReferrer(const String& httpReferrer) { setHTTPHeaderField("Referer", httpReferrer); }
100         void clearHTTPReferrer();
101         
102         String httpOrigin() const { return httpHeaderField("Origin"); }
103         void setHTTPOrigin(const String& httpOrigin) { setHTTPHeaderField("Origin", httpOrigin); }
104         void clearHTTPOrigin();
105
106         String httpUserAgent() const { return httpHeaderField("User-Agent"); }
107         void setHTTPUserAgent(const String& httpUserAgent) { setHTTPHeaderField("User-Agent", httpUserAgent); }
108         void clearHTTPUserAgent();
109
110         String httpAccept() const { return httpHeaderField("Accept"); }
111         void setHTTPAccept(const String& httpAccept) { setHTTPHeaderField("Accept", httpAccept); }
112         void clearHTTPAccept();
113
114         const Vector<String>& responseContentDispositionEncodingFallbackArray() const { return m_responseContentDispositionEncodingFallbackArray; }
115         void setResponseContentDispositionEncodingFallbackArray(const String& encoding1, const String& encoding2 = String(), const String& encoding3 = String());
116
117         FormData* httpBody() const;
118         void setHTTPBody(PassRefPtr<FormData> httpBody);
119         
120         bool allowCookies() const;
121         void setAllowCookies(bool allowCookies);
122
123         ResourceLoadPriority priority() const;
124         void setPriority(ResourceLoadPriority);
125
126         bool isConditional() const;
127         void makeUnconditional();
128
129         // Whether the associated ResourceHandleClient needs to be notified of
130         // upload progress made for that resource.
131         bool reportUploadProgress() const { return m_reportUploadProgress; }
132         void setReportUploadProgress(bool reportUploadProgress) { m_reportUploadProgress = reportUploadProgress; }
133
134         // Whether the timing information should be collected for the request.
135         bool reportLoadTiming() const { return m_reportLoadTiming; }
136         void setReportLoadTiming(bool reportLoadTiming) { m_reportLoadTiming = reportLoadTiming; }
137
138         // Whether actual headers being sent/received should be collected and reported for the request.
139         bool reportRawHeaders() const { return m_reportRawHeaders; }
140         void setReportRawHeaders(bool reportRawHeaders) { m_reportRawHeaders = reportRawHeaders; }
141
142         static double defaultTimeoutInterval(); // May return 0 when using platform default.
143         static void setDefaultTimeoutInterval(double);
144
145 #if PLATFORM(IOS)
146         static bool defaultAllowCookies();
147         static void setDefaultAllowCookies(bool);
148 #endif
149
150         static bool compare(const ResourceRequest&, const ResourceRequest&);
151
152     protected:
153         // Used when ResourceRequest is initialized from a platform representation of the request
154         ResourceRequestBase()
155             : m_resourceRequestUpdated(false)
156             , m_platformRequestUpdated(true)
157             , m_resourceRequestBodyUpdated(false)
158             , m_platformRequestBodyUpdated(true)
159             , m_reportUploadProgress(false)
160             , m_reportLoadTiming(false)
161             , m_reportRawHeaders(false)
162             , m_priority(ResourceLoadPriorityLow)
163         {
164         }
165
166         ResourceRequestBase(const URL& url, ResourceRequestCachePolicy policy)
167             : m_url(url)
168             , m_cachePolicy(policy)
169             , m_timeoutInterval(s_defaultTimeoutInterval)
170             , m_httpMethod(ASCIILiteral("GET"))
171 #if !PLATFORM(IOS)
172             , m_allowCookies(true)
173 #else
174             , m_allowCookies(ResourceRequestBase::defaultAllowCookies())
175 #endif
176             , m_resourceRequestUpdated(true)
177             , m_platformRequestUpdated(false)
178             , m_resourceRequestBodyUpdated(true)
179             , m_platformRequestBodyUpdated(false)
180             , m_reportUploadProgress(false)
181             , m_reportLoadTiming(false)
182             , m_reportRawHeaders(false)
183             , m_priority(ResourceLoadPriorityLow)
184         {
185         }
186
187         void updatePlatformRequest(HTTPBodyUpdatePolicy = DoNotUpdateHTTPBody) const;
188         void updateResourceRequest(HTTPBodyUpdatePolicy = DoNotUpdateHTTPBody) const;
189
190         // The ResourceRequest subclass may "shadow" this method to compare platform specific fields
191         static bool platformCompare(const ResourceRequest&, const ResourceRequest&) { return true; }
192
193         URL m_url;
194
195         ResourceRequestCachePolicy m_cachePolicy;
196         double m_timeoutInterval; // 0 is a magic value for platform default on platforms that have one.
197         URL m_firstPartyForCookies;
198         String m_httpMethod;
199         HTTPHeaderMap m_httpHeaderFields;
200         Vector<String> m_responseContentDispositionEncodingFallbackArray;
201         RefPtr<FormData> m_httpBody;
202         bool m_allowCookies : 1;
203         mutable bool m_resourceRequestUpdated : 1;
204         mutable bool m_platformRequestUpdated : 1;
205         mutable bool m_resourceRequestBodyUpdated : 1;
206         mutable bool m_platformRequestBodyUpdated : 1;
207         bool m_reportUploadProgress : 1;
208         bool m_reportLoadTiming : 1;
209         bool m_reportRawHeaders : 1;
210         ResourceLoadPriority m_priority;
211
212     private:
213         const ResourceRequest& asResourceRequest() const;
214
215         static double s_defaultTimeoutInterval;
216 #if PLATFORM(IOS)
217         static bool s_defaultAllowCookies;
218 #endif
219     };
220
221     bool equalIgnoringHeaderFields(const ResourceRequestBase&, const ResourceRequestBase&);
222
223     inline bool operator==(const ResourceRequest& a, const ResourceRequest& b) { return ResourceRequestBase::compare(a, b); }
224     inline bool operator!=(ResourceRequest& a, const ResourceRequest& b) { return !(a == b); }
225
226     struct CrossThreadResourceRequestDataBase {
227         WTF_MAKE_NONCOPYABLE(CrossThreadResourceRequestDataBase); WTF_MAKE_FAST_ALLOCATED;
228     public:
229         CrossThreadResourceRequestDataBase() { }
230         URL m_url;
231
232         ResourceRequestCachePolicy m_cachePolicy;
233         double m_timeoutInterval;
234         URL m_firstPartyForCookies;
235
236         String m_httpMethod;
237         OwnPtr<CrossThreadHTTPHeaderMapData> m_httpHeaders;
238         Vector<String> m_responseContentDispositionEncodingFallbackArray;
239         RefPtr<FormData> m_httpBody;
240         bool m_allowCookies;
241         ResourceLoadPriority m_priority;
242     };
243     
244     unsigned initializeMaximumHTTPConnectionCountPerHost();
245 #if PLATFORM(IOS)
246     void initializeHTTPConnectionSettingsOnStartup();
247 #endif
248 } // namespace WebCore
249
250 #endif // ResourceRequestBase_h