Coalesce small buffers in net::BidirectionalStream

components/cronet/ios/cronet_c_for_grpc.h

 // Copyright 2016 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.
 
 #ifndef COMPONENTS_CRONET_IOS_CRONET_C_FOR_GRPC_H_
 #define COMPONENTS_CRONET_IOS_CRONET_C_FOR_GRPC_H_
 
 #ifdef __cplusplus
 extern "C" {
 #endif
@@ skipping 25 matching lines @@
 
 /* Array of request or response headers or trailers. */
 typedef struct cronet_bidirectional_stream_header_array {
   size_t count;
   size_t capacity;
   cronet_bidirectional_stream_header* headers;
 } cronet_bidirectional_stream_header_array;
 
 /* Set of callbacks used to receive callbacks from bidirectional stream. */
 typedef struct cronet_bidirectional_stream_callback {
-  /* Invoked when request headers are sent. Indicates that stream has initiated
-   * the request. Consumer may call cronet_bidirectional_stream_write() to start
-   * writing data.
+  /* Invoked when the stream is ready for reading and writing.
+   * Consumer may call cronet_bidirectional_stream_read() to start reading data.
+   * Consumer may call cronet_bidirectional_stream_write() to start writing
+   * data.
    */
-  void (*on_request_headers_sent)(cronet_bidirectional_stream* stream);
+  void (*on_stream_ready)(cronet_bidirectional_stream* stream);
 
   /* Invoked when initial response headers are received.
    * Consumer must call cronet_bidirectional_stream_read() to start reading.
    * Consumer may call cronet_bidirectional_stream_write() to start writing or
    * close the stream. Contents of |headers| is valid for duration of the call.
    */
   void (*on_response_headers_received)(
       cronet_bidirectional_stream* stream,
       const cronet_bidirectional_stream_header_array* headers,
       const char* negotiated_protocol);
@@ skipping 86 matching lines @@
 int cronet_bidirectional_stream_start(
     cronet_bidirectional_stream* stream,
     const char* url,
     int priority,
     const char* method,
     const cronet_bidirectional_stream_header_array* headers,
     bool end_of_stream);
 
 /* Read response data into |buffer| of |capacity| length. Must only be called at
  * most once in response to each invocation of the
- * on_response_headers_received() and on_read_completed() methods of the
- * cronet_bidirectional_stream_callback.
+ * on_stream_ready()/on_response_headers_received() and on_read_completed()
+ * methods of the cronet_bidirectional_stream_callback.
  * Each call will result in an invocation of the callback's
  * on_read_completed() method if data is read, or its on_failed() method if
  * there's an error. The callback's on_succeeded() method is also invoked if
  * there is no more data to read and |end_of_stream| was previously sent.
  */
 int cronet_bidirectional_stream_read(cronet_bidirectional_stream* stream,
                                      char* buffer,
                                      int capacity);
 
 /* Write request data from |buffer| of |buffer_length| length. Must only be
  * called at most once in response to each invocation of the
- * on_request_headers_sent() and on_write_completed() methods of the
+ * on_stream_ready() and on_write_completed() methods of the
  * cronet_bidirectional_stream_callback.
  * Each call will result in an invocation the callback's on_write_completed()
  * method if data is sent, or its on_failed() method if there's an error.
  * The callback's on_succeeded() method is also invoked if |end_of_stream| is
  * set and all response data has been read.
  */
 int cronet_bidirectional_stream_write(cronet_bidirectional_stream* stream,
                                       const char* buffer,
                                       int buffer_length,
                                       bool end_of_stream);
@@ skipping 13 matching lines @@
  * (succeeded, canceled, or failed).
  * Returns false if the |stream| stream is not yet started or is in progress.
  */
 bool cronet_bidirectional_stream_is_done(cronet_bidirectional_stream* stream);
 
 #ifdef __cplusplus
 }
 #endif
 
 #endif  // COMPONENTS_CRONET_IOS_CRONET_C_FOR_GRPC_H_