#include <userver/ugrpc/server/rpc.hpp>
Controls a single request -> response stream RPC.
This class is not thread-safe except for GetContext
.
The RPC is cancelled on destruction unless the stream has been finished.
If any method throws, further methods must not be called on the same stream, except for GetContext
.
Public Member Functions | |
void | Write (const Response &response) |
Write the next outgoing message. | |
void | Finish () |
Complete the RPC successfully. | |
void | FinishWithError (const grpc::Status &status) override |
Complete the RPC with an error. | |
void | WriteAndFinish (const Response &response) |
Equivalent to Write + Finish | |
OutputStream (impl::CallParams &&call_params, impl::RawWriter< Response > &stream) | |
For internal use only. | |
OutputStream (OutputStream &&)=delete | |
OutputStream & | operator= (OutputStream &&)=delete |
bool | IsFinished () const override |
Public Member Functions inherited from ugrpc::server::CallAnyBase | |
CallAnyBase (impl::CallParams &¶ms) | |
grpc::ServerContext & | GetContext () |
std::string_view | GetCallName () const |
Name of the call. Consists of service and method names. | |
tracing::Span & | GetSpan () |
utils::AnyStorage< StorageContext > & | GetStorageContext () |
Returns call context for storing per-call custom data. | |
Additional Inherited Members | |
Protected Member Functions inherited from ugrpc::server::CallAnyBase | |
ugrpc::impl::RpcStatisticsScope & | Statistics () |
logging::LoggerRef | AccessTskvLogger () |
void | LogFinish (grpc::Status status) const |
ugrpc::server::OutputStream< Response >::OutputStream | ( | impl::CallParams && | call_params, |
impl::RawWriter< Response > & | stream ) |
ugrpc::server::OutputStream< Response >::~OutputStream | ( | ) |
void ugrpc::server::OutputStream< Response >::Finish | ( | ) |
Complete the RPC successfully.
Finish
must not be called multiple times.
ugrpc::server::RpcError | on an RPC error |
|
overridevirtual |
Complete the RPC with an error.
Finish
must not be called multiple times.
status | error details |
ugrpc::server::RpcError | on an RPC error |
Implements ugrpc::server::CallAnyBase.
|
overridevirtual |
Implements ugrpc::server::CallAnyBase.
void ugrpc::server::OutputStream< Response >::Write | ( | const Response & | response | ) |
Write the next outgoing message.
response | the next message to write |
ugrpc::server::RpcError | on an RPC error |
void ugrpc::server::OutputStream< Response >::WriteAndFinish | ( | const Response & | response | ) |
Equivalent to Write + Finish
This call saves one round-trip, compared to separate Write
and Finish
.
Finish
must not be called multiple times.
response | the final response message |
ugrpc::server::RpcError | on an RPC error |