resource_fetcher.h revision 5f1c94371a64b3196d4be9466099bb892df9b88e
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::RequestContext request_context, 55 blink::WebURLRequest::FrameType frame_type, 56 const Callback& callback) = 0; 57 58 // 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. 60 virtual void SetTimeout(const base::TimeDelta& timeout) = 0; 61}; 62 63} // namespace content 64 65#endif // CONTENT_PUBLIC_RENDERER_RESOURCE_FETCHER_H_ 66