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 |