Prototype of chunked transfer encoded POST.

chrome/common/net/url_fetcher.h

 // Copyright (c) 2011 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.
 //
 // This file contains URLFetcher, a wrapper around net::URLRequest that handles
 // low-level details like thread safety, ref counting, and incremental buffer
 // reading.  This is useful for callers who simply want to get the data from a
 // URL and don't care about all the nitty-gritty details.
 //
 // NOTE(willchan): Only one "IO" thread is supported for URLFetcher.  This is a
@@ skipping 114 matching lines @@
   static URLFetcher* Create(int id, const GURL& url, RequestType request_type,
                             Delegate* d);
 
   // Sets data only needed by POSTs.  All callers making POST requests should
   // call this before the request is started.  |upload_content_type| is the MIME
   // type of the content, while |upload_content| is the data to be sent (the
   // Content-Length header value will be set to the length of this data).
   void set_upload_data(const std::string& upload_content_type,
                        const std::string& upload_content);
 
+  // Indicates that the POST data is sent via chunked transfer encoding.
+  // This may only be called before calling Start().
+  // Use AppendChunkToUpload() to give the data chunks after calling Start().
+  void set_chunked_upload(const std::string& upload_content_type);
+
+  // Adds the given bytes to a requests's POST data transmitted using chunked

[wtc, 2011/01/20 00:29:47]

Nit: requests's => request's

+  // transfer encoding.
+  // This method should be called ONLY after calling Start().
+  void AppendChunkToUpload(const std::string& data);
+  void MarkEndOfChunks();

[wtc, 2011/01/20 00:29:47]

Document the MarkEndOfChunks method.

+
   // Set one or more load flags as defined in net/base/load_flags.h.  Must be
   // called before the request is started.
   void set_load_flags(int load_flags);
 
   // Returns the current load flags.
   int load_flags() const;
 
   // Set extra headers on the request.  Must be called before the request
   // is started.
   void set_extra_request_headers(const std::string& extra_request_headers);
@@ skipping 68 matching lines @@
   base::TimeDelta backoff_delay_;
   // Maximum retries allowed.
   int max_retries_;
 
   static bool g_interception_enabled;
 
   DISALLOW_COPY_AND_ASSIGN(URLFetcher);
 };
 
 #endif  // CHROME_COMMON_NET_URL_FETCHER_H_