resource_fetcher.h revision 5d1f7b1de12d16ceb2c938c56701a3e8bfa558f7 
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
3// found in the LICENSE file.
4
5#ifndef CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_
6#define CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_
7
8#include <string>
9
10#include "base/callback.h"
11#include "content/common/content_export.h"
12#include "third_party/WebKit/public/platform/WebURLRequest.h"
13
14class GURL;
15
16namespace base {
17class TimeDelta;
18}
19
20namespace blink {
21class WebFrame;
22class WebURLResponse;
23}
24
25namespace content {
26
27// Interface to download resources asynchronously.
28class CONTENT_EXPORT ResourceFetcher {
29 public:
30  virtual ~ResourceFetcher() {}
31
32  // 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
34  // empty.  |response| and |data| are both valid until the URLFetcher instance
35  // is destroyed.
36  typedef base::Callback<void(const blink::WebURLResponse& response,
37                              const std::string& data)> Callback;
38
39  // Creates a ResourceFetcher for the specified resource.  Caller takes
40  // ownership of the returned object.  Deleting the ResourceFetcher will cancel
41  // the request, and the callback will never be run.
42  static ResourceFetcher* Create(const GURL& url);
43
44  // Set the corresponding parameters of the request.  Must be called before
45  // Start.  By default, requests are GETs with no body.
46  virtual void SetMethod(const std::string& method) = 0;
47  virtual void SetBody(const std::string& body) = 0;
48  virtual void SetHeader(const std::string& header,
49                         const std::string& value) = 0;
50
51  // Starts the request using the specified frame.  Calls |callback| when
52  // done.
53  virtual void Start(blink::WebFrame* frame,
54                     blink::WebURLRequest::TargetType target_type,
55                     const Callback& callback) = 0;
56
57  // Sets how long to wait for the server to reply.  By default, there is no
58  // timeout.  Must be called after a request is started.
59  virtual void SetTimeout(const base::TimeDelta& timeout) = 0;
60};
61
62}  // namespace content
63
64#endif  // CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_
65