| OLD | NEW |
| 1 // Copyright 2013 The Chromium Authors. All rights reserved. | 1 // Copyright 2013 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_ | 5 #ifndef CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_ |
| 6 #define CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_ | 6 #define CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 | 9 |
| 10 #include "base/callback.h" | 10 #include "base/callback.h" |
| 11 #include "content/common/content_export.h" | 11 #include "content/common/content_export.h" |
| 12 #include "third_party/WebKit/public/platform/WebURLRequest.h" | 12 #include "third_party/WebKit/public/platform/WebURLRequest.h" |
| 13 | 13 |
| 14 class GURL; | 14 class GURL; |
| 15 | 15 |
| 16 namespace base { | 16 namespace base { |
| 17 class TimeDelta; | 17 class TimeDelta; |
| 18 } | 18 } |
| 19 | 19 |
| 20 namespace blink { | 20 namespace blink { |
| 21 class WebFrame; | 21 class WebFrame; |
| 22 class WebURLResponse; | 22 class WebURLResponse; |
| 23 } | 23 } |
| 24 | 24 |
| 25 namespace content { | 25 namespace content { |
| 26 | 26 |
| 27 // Interface to download resources asynchronously. | 27 // Interface to download resources asynchronously. |
| 28 class CONTENT_EXPORT ResourceFetcher { | 28 class CONTENT_EXPORT ResourceFetcher { |
| 29 public: | 29 public: |
| 30 enum LoaderType { |
| 31 PLATFORM_LOADER, // uses Platform::createURLLoader |
| 32 FRAME_ASSOCIATED_LOADER, // uses WebFrame::createAssociatedURLLoader |
| 33 }; |
| 34 |
| 30 virtual ~ResourceFetcher() {} | 35 virtual ~ResourceFetcher() {} |
| 31 | 36 |
| 32 // This will be called asynchronously after the URL has been fetched, | 37 // This will be called asynchronously after the URL has been fetched, |
| 33 // successfully or not. If there is a failure, response and data will both be | 38 // successfully or not. If there is a failure, response and data will both be |
| 34 // empty. |response| and |data| are both valid until the URLFetcher instance | 39 // empty. |response| and |data| are both valid until the URLFetcher instance |
| 35 // is destroyed. | 40 // is destroyed. |
| 36 typedef base::Callback<void(const blink::WebURLResponse& response, | 41 typedef base::Callback<void(const blink::WebURLResponse& response, |
| 37 const std::string& data)> Callback; | 42 const std::string& data)> Callback; |
| 38 | 43 |
| 39 // Creates a ResourceFetcher for the specified resource. Caller takes | 44 // Creates a ResourceFetcher for the specified resource. Caller takes |
| 40 // ownership of the returned object. Deleting the ResourceFetcher will cancel | 45 // ownership of the returned object. Deleting the ResourceFetcher will cancel |
| 41 // the request, and the callback will never be run. | 46 // the request, and the callback will never be run. |
| 42 static ResourceFetcher* Create(const GURL& url); | 47 static ResourceFetcher* Create(const GURL& url); |
| 43 | 48 |
| 44 // Set the corresponding parameters of the request. Must be called before | 49 // Set the corresponding parameters of the request. Must be called before |
| 45 // Start. By default, requests are GETs with no body. | 50 // Start. By default, requests are GETs with no body. |
| 46 virtual void SetMethod(const std::string& method) = 0; | 51 virtual void SetMethod(const std::string& method) = 0; |
| 47 virtual void SetBody(const std::string& body) = 0; | 52 virtual void SetBody(const std::string& body) = 0; |
| 48 virtual void SetHeader(const std::string& header, | 53 virtual void SetHeader(const std::string& header, |
| 49 const std::string& value) = 0; | 54 const std::string& value) = 0; |
| 50 | 55 |
| 51 // Starts the request using the specified frame. Calls |callback| when | 56 // Starts the request using the specified frame. Calls |callback| when |
| 52 // done. | 57 // done. |
| 53 virtual void Start(blink::WebFrame* frame, | 58 virtual void Start(blink::WebFrame* frame, |
| 54 blink::WebURLRequest::RequestContext request_context, | 59 blink::WebURLRequest::RequestContext request_context, |
| 55 blink::WebURLRequest::FrameType frame_type, | 60 blink::WebURLRequest::FrameType frame_type, |
| 61 LoaderType loader_type, |
| 56 const Callback& callback) = 0; | 62 const Callback& callback) = 0; |
| 57 | 63 |
| 58 // Sets how long to wait for the server to reply. By default, there is no | 64 // Sets how long to wait for the server to reply. By default, there is no |
| 59 // timeout. Must be called after a request is started. | 65 // timeout. Must be called after a request is started. |
| 60 virtual void SetTimeout(const base::TimeDelta& timeout) = 0; | 66 virtual void SetTimeout(const base::TimeDelta& timeout) = 0; |
| 67 |
| 68 // Manually cancel the request. |
| 69 virtual void Cancel() = 0; |
| 61 }; | 70 }; |
| 62 | 71 |
| 63 } // namespace content | 72 } // namespace content |
| 64 | 73 |
| 65 #endif // CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_ | 74 #endif // CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_ |
| OLD | NEW |