content/child/multipart_response_delegate.h

   1 // Copyright 2014 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 // A delegate class of WebURLLoaderImpl that handles multipart/x-mixed-replace
   6 // data.  We special case multipart/x-mixed-replace because WebCore expects a
   7 // separate didReceiveResponse for each new message part.
   8 //
   9 // Most of the logic and edge case handling are based on the Mozilla's
  10 // implementation in netwerk/streamconv/converters/nsMultiMixedConv.cpp.
  11 // This seems like a derivative work, so here's the original license:
  12
  13 /* ***** BEGIN LICENSE BLOCK *****
  14  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
  15  *
  16  * The contents of this file are subject to the Mozilla Public License Version
  17  * 1.1 (the "License"); you may not use this file except in compliance with
  18  * the License. You may obtain a copy of the License at
  19  * http://www.mozilla.org/MPL/
  20  *
  21  * Software distributed under the License is distributed on an "AS IS" basis,
  22  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  23  * for the specific language governing rights and limitations under the
  24  * License.
  25  *
  26  * The Original Code is mozilla.org code.
  27  *
  28  * The Initial Developer of the Original Code is
  29  * Netscape Communications Corporation.
  30  * Portions created by the Initial Developer are Copyright (C) 1998
  31  * the Initial Developer. All Rights Reserved.
  32  *
  33  * Contributor(s):
  34  *
  35  * Alternatively, the contents of this file may be used under the terms of
  36  * either the GNU General Public License Version 2 or later (the "GPL"), or
  37  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  38  * in which case the provisions of the GPL or the LGPL are applicable instead
  39  * of those above. If you wish to allow use of your version of this file only
  40  * under the terms of either the GPL or the LGPL, and not to allow others to
  41  * use your version of this file under the terms of the MPL, indicate your
  42  * decision by deleting the provisions above and replace them with the notice
  43  * and other provisions required by the GPL or the LGPL. If you do not delete
  44  * the provisions above, a recipient may use your version of this file under
  45  * the terms of any one of the MPL, the GPL or the LGPL.
  46  *
  47  * ***** END LICENSE BLOCK ***** */
  48
  49 #ifndef CONTENT_CHILD_MULTIPART_RESPONSE_DELEGATE_H_
  50 #define CONTENT_CHILD_MULTIPART_RESPONSE_DELEGATE_H_
  51
  52 #include <string>
  53
  54 #include "base/basictypes.h"
  55 #include "content/common/content_export.h"
  56 #include "third_party/WebKit/public/platform/WebURLResponse.h"
  57
  58 namespace blink {
  59 class WebURLLoader;
  60 class WebURLLoaderClient;
  61 }
  62
  63 namespace content {
  64
  65 class CONTENT_EXPORT MultipartResponseDelegate {
  66  public:
  67   MultipartResponseDelegate(blink::WebURLLoaderClient* client,
  68                             blink::WebURLLoader* loader,
  69                             const blink::WebURLResponse& response,
  70                             const std::string& boundary);
  71
  72   // Passed through from ResourceHandleInternal
  73   void OnReceivedData(const char* data, int data_len, int encoded_data_length);
  74   void OnCompletedRequest();
  75
  76   // The request has been canceled, so stop making calls to the client.
  77   void Cancel() {
  78     client_ = NULL;
  79     loader_ = NULL;
  80   }
  81
  82   // Returns the multi part boundary string from the Content-type header
  83   // in the response.
  84   // Returns true on success.
  85   static bool ReadMultipartBoundary(const blink::WebURLResponse& response,
  86                                     std::string* multipart_boundary);
  87
  88   // Returns the lower and higher content ranges from an individual multipart
  89   // in a multipart response.
  90   // Returns true on success.
  91   static bool ReadContentRanges(
  92       const blink::WebURLResponse& response,
  93       int64* content_range_lower_bound,
  94       int64* content_range_upper_bound,
  95       int64* content_range_instance_size);
  96
  97  private:
  98   friend class MultipartResponseDelegateTester;  // For unittests.
  99
 100   // Pointers to the client and associated loader so we can make callbacks as
 101   // we parse pieces of data.
 102   blink::WebURLLoaderClient* client_;
 103   blink::WebURLLoader* loader_;
 104
 105   // The original resource response for this request.  We use this as a
 106   // starting point for each parts response.
 107   blink::WebURLResponse original_response_;
 108
 109   // Checks to see if data[pos] character is a line break; handles crlf, lflf,
 110   // lf, or cr. Returns the number of characters to skip over (0, 1 or 2).
 111   int PushOverLine(const std::string& data, size_t pos);
 112
 113   // Tries to parse http headers from the start of data_.  Returns true if it
 114   // succeeds and sends a didReceiveResponse to m_client.  Returns false if
 115   // the header is incomplete (in which case we just wait for more data).
 116   bool ParseHeaders();
 117
 118   // Find the next boundary in data_.  Returns std::string::npos if there's no
 119   // full token.
 120   size_t FindBoundary();
 121
 122   // Transferred data size accumulated between client callbacks.
 123   int encoded_data_length_;
 124
 125   // A temporary buffer to hold data between reads for multipart data that
 126   // gets split in the middle of a header.
 127   std::string data_;
 128
 129   // Multipart boundary token
 130   std::string boundary_;
 131
 132   // true until we get our first on received data call
 133   bool first_received_data_;
 134
 135   // true if we're truncated in the middle of a header
 136   bool processing_headers_;
 137
 138   // true when we're done sending information.  At that point, we stop
 139   // processing AddData requests.
 140   bool stop_sending_;
 141
 142   // true after we've sent our first response to the WebURLLoaderClient.
 143   bool has_sent_first_response_;
 144
 145   DISALLOW_COPY_AND_ASSIGN(MultipartResponseDelegate);
 146 };
 147
 148 }  // namespace content
 149
 150 #endif  // CONTENT_CHILD_MULTIPART_RESPONSE_DELEGATE_H_