Pepper stream-to-file plumbing....

webkit/glue/resource_loader_bridge.h

 // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 //
 // The intent of this file is to provide a type-neutral abstraction between
 // Chrome and WebKit for resource loading. This pure-virtual interface is
 // implemented by the embedder, which also provides a factory method Create
 // to instantiate this object.
 //
 // One of these objects will be created by WebKit for each request. WebKit
 // will own the pointer to the bridge, and will delete it when the request is
 // no longer needed.
 //
 // In turn, the bridge's owner on the WebKit end will implement the Peer
 // interface, which we will use to communicate notifications back.
 
 #ifndef WEBKIT_GLUE_RESOURCE_LOADER_BRIDGE_H_
 #define WEBKIT_GLUE_RESOURCE_LOADER_BRIDGE_H_
 
 #include "build/build_config.h"
 #if defined(OS_POSIX)
 #include "base/file_descriptor_posix.h"
 #endif
+#include "base/file_path.h"
 #include "base/platform_file.h"
 #include "base/ref_counted.h"
 #include "base/time.h"
 #include "googleurl/src/gurl.h"
 #include "net/url_request/url_request_status.h"
 #include "webkit/glue/resource_type.h"
 
 namespace net {
 class HttpResponseHeaders;
 }
 
-class FilePath;
-
 namespace webkit_glue {
 
 class ResourceLoaderBridge {
  public:
   // Structure used when calling ResourceLoaderBridge::Create().
   struct RequestInfo {
     RequestInfo();
     ~RequestInfo();
 
     // HTTP-style method name (e.g., "GET" or "POST").
@@ skipping 30 matching lines @@
     ResourceType::Type request_type;
 
     // Used for plugin to browser requests.
     uint32 request_context;
 
     // Identifies what appcache host this request is associated with.
     int appcache_host_id;
 
     // Used to associated the bridge with a frame's network context.
     int routing_id;
+
+    // If true, then the response body will be downloaded to a file and the
+    // path to that file will be provided in ResponseInfo::download_file_path.
+    bool download_to_file;
   };
 
   // Structure containing timing information for the request. It addresses
   // http://groups.google.com/group/http-archive-specification/web/har-1-1-spec
   // and http://dev.w3.org/2006/webapi/WebTiming/ needs.
   //
   // All the values for starts and ends are given in milliseconds and are
   // offsets with respect to the given base time.
   struct LoadTimingInfo {
     LoadTimingInfo();
@@ skipping 87 matching lines @@
     // is no associated connection, contains 0.
     uint32 connection_id;
 
     // Determines whether physical connection reused.
     bool connection_reused;
 
     // Detailed timing information used by the WebTiming, HAR and Developer
     // Tools.
     LoadTimingInfo load_timing;
 
+    // The path to a file that will contain the response body.  It may only
+    // contain a portion of the response body at the time that the ResponseInfo
+    // becomes available.
+    FilePath download_file_path;
+
     // True if the response was delivered using SPDY.
     bool was_fetched_via_spdy;
 
     // True if the response was delivered after NPN is negotiated.
     bool was_npn_negotiated;
 
     // True if response could use alternate protocol. However, browser will
     // ignore the alternate protocol when spdy is not enabled on browser side.
     bool was_alternate_protocol_available;
 
@@ skipping 47 matching lines @@
                                     bool* has_new_first_party_for_cookies,
                                     GURL* new_first_party_for_cookies) = 0;
 
     // Called when response headers are available (after all redirects have
     // been followed).  |content_filtered| is set to true if the contents is
     // altered or replaced (usually for security reasons when the resource is
     // deemed unsafe).
     virtual void OnReceivedResponse(const ResponseInfo& info,
                                     bool content_filtered) = 0;
 
+    // Called when a chunk of response data is downloaded.  This method may be
+    // called multiple times or not at all if an error occurs.  This method is
+    // only called if RequestInfo::download_to_file was set to true, and in
+    // that case, OnReceivedData will not be called.
+    virtual void OnDownloadedData(int len) = 0;
+
     // Called when a chunk of response data is available. This method may
     // be called multiple times or not at all if an error occurs.
     virtual void OnReceivedData(const char* data, int len) = 0;
 
     // Called when metadata generated by the renderer is retrieved from the
     // cache. This method may be called zero or one times.
     virtual void OnReceivedCachedMetadata(const char* data, int len) { }
 
     // Called when the response is complete.  This method signals completion of
     // the resource load.ff
@@ skipping 65 matching lines @@
   // construction must go through Create()
   ResourceLoaderBridge();
 
  private:
   DISALLOW_COPY_AND_ASSIGN(ResourceLoaderBridge);
 };
 
 }  // namespace webkit_glue
 
 #endif  // WEBKIT_GLUE_RESOURCE_LOADER_BRIDGE_H_