Implement content::WebSocketBlobSender

content/common/websocket_messages.h

 // Copyright 2013 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.
 
 // Multiply-included message file, hence no include guard.
 
 // This file defines the IPCs for the browser-side implementation of
 // WebSockets.
 //
 // This IPC interface was originally desined based on the WebSocket
@@ skipping 55 matching lines @@
 
 // Open new WebSocket connection to |socket_url|. |requested_protocols| is a
 // list of tokens identifying sub-protocols the renderer would like to use, as
 // described in RFC6455 "Subprotocols Using the WebSocket Protocol".
 IPC_MESSAGE_ROUTED4(WebSocketHostMsg_AddChannelRequest,
                     GURL /* socket_url */,
                     std::vector<std::string> /* requested_protocols */,
                     url::Origin /* origin */,
                     int /* render_frame_id */)
 
+// Send a complete binary WebSocket message consisting of the Blob identified by
+// |uuid|. The message will be split into frames as necessary. |expected_size|
+// must match the browser's idea of the size of the Blob to prevent flow control
+// from becoming desynchronised. If it does not match the connection will be
+// terminated with a WebSocketMsg_NotifyFailure message. On success, the browser
+// will have consumed |expected_size| bytes of flow control send quota and the
+// renderer needs to subtract that from its running total of flow control send
+// quota. See the design doc at
+// https://docs.google.com/document/d/1CDiXB9pBumhFVVfmIn1CRI6v6byxyqWu2urEE9xp714/edit
+// SendFrame or SendBlob IPCs must not be sent by the renderer until the
+// BlobSendComplete message has been received from the browser. The renderer
+// should retain a reference to the Blob until either a BlobSendComplete or
+// NotifyFailure IPC is received.
+IPC_MESSAGE_ROUTED2(WebSocketHostMsg_SendBlob,
+                    std::string /* uuid */,
+                    uint64_t /* expected_size */)
+
 // WebSocket messages sent from the browser to the renderer.
 
 // Respond to an AddChannelRequest. |selected_protocol| is the sub-protocol the
 // server selected, or empty if no sub-protocol was selected. |extensions| is
 // the list of extensions negotiated for the connection.
 IPC_MESSAGE_ROUTED2(WebSocketMsg_AddChannelResponse,
                     std::string /* selected_protocol */,
                     std::string /* extensions */)
 
 // Notify the renderer that the browser has started an opening handshake.
@@ skipping 18 matching lines @@
 // 1. Fire an error event.
 // 2. Show |message| to the inspector.
 // 3. Close the channel immediately uncleanly, as if it received
 //    DropChannel(was_clean = false, code = 1006, reason = "").
 // |message| will be shown in the inspector and won't be passed to the script.
 // TODO(yhirano): Find the way to pass |message| directly to the inspector
 // process.
 IPC_MESSAGE_ROUTED1(WebSocketMsg_NotifyFailure,
                     std::string /* message */)
 
+// Indicates tbat the current Blob has finished sending. The renderer can
+// release its reference on the Blob, and may now use SendFrame or SendBlob to
+// send more messages.
+IPC_MESSAGE_ROUTED0(WebSocketMsg_BlobSendComplete);
+
 // WebSocket messages that can be sent in either direction.
 
 // Send a non-control frame to the channel.
 // - If the sender is the renderer, it will be sent to the remote server.
 // - If the sender is the browser, it comes from the remote server.
 //
 // - |fin| indicates that this frame is the last in the current message.
 // - |type| is the type of the message. On the first frame of a message, it
 //   must be set to either WEB_SOCKET_MESSAGE_TYPE_TEXT or
 //   WEB_SOCKET_MESSAGE_TYPE_BINARY. On subsequent frames, it must be set to
@@ skipping 32 matching lines @@
 //   a closing handshake and the renderer cannot accept any new messages on this
 //   connection.
 IPC_MESSAGE_ROUTED3(WebSocketMsg_DropChannel,
                     bool /* was_clean */,
                     unsigned short /* code */,
                     std::string /* reason */)
 
 // Notify the renderer that a closing handshake has been initiated by the
 // server, so that it can set the Javascript readyState to CLOSING.
 IPC_MESSAGE_ROUTED0(WebSocketMsg_NotifyClosing)