Interface ClientStream<RequestT> (2.66.0)

A wrapper used to send requests to the server.

After sending requests, users must either call #closeSend() or #closeSendWithError(Throwable) on the stream. The error, if any, will be propagated to the server.

Example usage:

   
 ClientStream<String> 
  
 stream 
  
 = 
  
 ...; 
  
 List<String> 
  
 lines 
  
 = 
  
 getLinesFromFile 
 (); 
  
 for 
  
 ( 
 String 
  
 line 
  
 : 
  
 lines 
 ) 
  
 { 
  
 stream 
 . 
 send 
 ( 
 line 
 ); 
  
 } 
  
 stream 
 . 
 closeSend 
 (); 
  
 

Closes the stream. If called, this must be the last call on this ClientStream .

Note that if close() itself throws, a further call to closeSendWithError is not allowed.

Closes the stream with an error. If called, this must be the last call on this ClientStream .

Reports whether a new request can be sent without excessive buffering.

This is only an optimization hint to the user. It is correct, if suboptimal, to call send if isSendReady returns false.

Sends a request to the server. It is an error to call this if the stream is already closed.