/* * Copyright (C) 2003, 2006 Apple Computer, Inc. All rights reserved. * Copyright (C) 2006 Samuel Weinig * 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 SKY_ENGINE_PLATFORM_NETWORK_RESOURCEREQUEST_H_ #define SKY_ENGINE_PLATFORM_NETWORK_RESOURCEREQUEST_H_ #include "sky/engine/platform/network/FormData.h" #include "sky/engine/platform/network/HTTPHeaderMap.h" #include "sky/engine/platform/network/HTTPParsers.h" #include "sky/engine/platform/network/ResourceLoadPriority.h" #include "sky/engine/platform/weborigin/KURL.h" #include "sky/engine/platform/weborigin/Referrer.h" #include "sky/engine/public/platform/WebURLRequest.h" #include "sky/engine/wtf/OwnPtr.h" namespace blink { enum ResourceRequestCachePolicy { 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 ReloadBypassingCache, // end-to-end reload }; class PLATFORM_EXPORT ResourceRequest { WTF_MAKE_FAST_ALLOCATED; public: class ExtraData : public RefCounted { public: virtual ~ExtraData() { } }; ResourceRequest() { initialize(KURL(), UseProtocolCachePolicy); } ResourceRequest(const String& urlString) { initialize(KURL(ParsedURLString, urlString), UseProtocolCachePolicy); } ResourceRequest(const KURL& url) { initialize(url, UseProtocolCachePolicy); } ResourceRequest(const KURL& url, const Referrer& referrer, ResourceRequestCachePolicy cachePolicy = UseProtocolCachePolicy) { initialize(url, cachePolicy); setHTTPReferrer(referrer); } bool isNull() const; bool isEmpty() const; const KURL& url() const; void setURL(const KURL& url); void removeCredentials(); ResourceRequestCachePolicy cachePolicy() const; void setCachePolicy(ResourceRequestCachePolicy cachePolicy); double timeoutInterval() const; // May return 0 when using platform default. void setTimeoutInterval(double timeoutInterval); const AtomicString& httpMethod() const; void setHTTPMethod(const AtomicString&); const HTTPHeaderMap& httpHeaderFields() const; const AtomicString& httpHeaderField(const AtomicString& name) const; const AtomicString& httpHeaderField(const char* name) const; void setHTTPHeaderField(const AtomicString& name, const AtomicString& value); void setHTTPHeaderField(const char* name, const AtomicString& value); void addHTTPHeaderField(const AtomicString& name, const AtomicString& value); void addHTTPHeaderFields(const HTTPHeaderMap& headerFields); void clearHTTPHeaderField(const AtomicString& name); void clearHTTPAuthorization(); const AtomicString& httpContentType() const { return httpHeaderField("Content-Type"); } void setHTTPContentType(const AtomicString& httpContentType) { setHTTPHeaderField("Content-Type", httpContentType); } const AtomicString& httpReferrer() const { return httpHeaderField("Referer"); } ReferrerPolicy referrerPolicy() const { return m_referrerPolicy; } void setHTTPReferrer(const Referrer& httpReferrer) { setHTTPHeaderField("Referer", httpReferrer.referrer); m_referrerPolicy = httpReferrer.referrerPolicy; } void clearHTTPReferrer(); const AtomicString& httpOrigin() const { return httpHeaderField("Origin"); } void setHTTPOrigin(const AtomicString& httpOrigin) { setHTTPHeaderField("Origin", httpOrigin); } void clearHTTPOrigin(); void addHTTPOriginIfNeeded(const AtomicString& origin); const AtomicString& httpAccept() const { return httpHeaderField("Accept"); } void setHTTPAccept(const AtomicString& httpAccept) { setHTTPHeaderField("Accept", httpAccept); } FormData* httpBody() const; void setHTTPBody(PassRefPtr httpBody); 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; } // True if request should be downloaded to file. bool downloadToFile() const { return m_downloadToFile; } void setDownloadToFile(bool downloadToFile) { m_downloadToFile = downloadToFile; } // Extra data associated with this request. ExtraData* extraData() const { return m_extraData.get(); } void setExtraData(PassRefPtr extraData) { m_extraData = extraData; } blink::WebURLRequest::RequestContext requestContext() const { return m_requestContext; } void setRequestContext(blink::WebURLRequest::RequestContext context) { m_requestContext = context; } blink::WebURLRequest::FrameType frameType() const { return m_frameType; } void setFrameType(blink::WebURLRequest::FrameType frameType) { m_frameType = frameType; } bool cacheControlContainsNoCache() const; bool cacheControlContainsNoStore() const; bool hasCacheValidatorFields() const; static double defaultTimeoutInterval(); // May return 0 when using platform default. static void setDefaultTimeoutInterval(double); static bool compare(const ResourceRequest&, const ResourceRequest&); private: void initialize(const KURL& url, ResourceRequestCachePolicy cachePolicy); const CacheControlHeader& cacheControlHeader() const; KURL m_url; ResourceRequestCachePolicy m_cachePolicy; double m_timeoutInterval; // 0 is a magic value for platform default on platforms that have one. AtomicString m_httpMethod; HTTPHeaderMap m_httpHeaderFields; RefPtr m_httpBody; bool m_allowStoredCredentials : 1; bool m_reportUploadProgress : 1; bool m_reportRawHeaders : 1; bool m_downloadToFile : 1; ResourceLoadPriority m_priority; int m_intraPriorityValue; int m_requestorID; int m_requestorProcessID; RefPtr m_extraData; blink::WebURLRequest::RequestContext m_requestContext; blink::WebURLRequest::FrameType m_frameType; ReferrerPolicy m_referrerPolicy; mutable CacheControlHeader m_cacheControlHeaderCache; static double s_defaultTimeoutInterval; }; bool equalIgnoringHeaderFields(const ResourceRequest&, const ResourceRequest&); inline bool operator==(const ResourceRequest& a, const ResourceRequest& b) { return ResourceRequest::compare(a, b); } inline bool operator!=(ResourceRequest& a, const ResourceRequest& b) { return !(a == b); } } // namespace blink #endif // SKY_ENGINE_PLATFORM_NETWORK_RESOURCEREQUEST_H_