Interface ClientStream<RequestT> (2.21.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.