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_ 151
