A ServerContext allows the person implementing a service handler to: More...

#include <server_context.h>

Public Member Functions
	ServerContext ()

	~ServerContext ()

std::chrono::system_clock::time_point	deadline () const
	Return the deadline for the server call. More...

gpr_timespec	raw_deadline () const
	Return a gpr_timespec representation of the server call's deadline. More...

void	AddInitialMetadata (const grpc::string &key, const grpc::string &value)
	Add the (meta_key, meta_value) pair to the initial metadata associated with a server call. More...

void	AddTrailingMetadata (const grpc::string &key, const grpc::string &value)
	Add the (meta_key, meta_value) pair to the initial metadata associated with a server call. More...

bool	IsCancelled () const
	IsCancelled is always safe to call when using sync API. More...

void	TryCancel () const
	Cancel the Call from the server. More...

const std::multimap< grpc::string_ref, grpc::string_ref > &	client_metadata () const
	Return a collection of initial metadata key-value pairs sent from the client. More...

grpc_compression_level	compression_level () const
	Return the compression algorithm to be used by the server call. More...

void	set_compression_level (grpc_compression_level level)
	Set algorithm to be the compression algorithm used for the server call. More...

bool	compression_level_set () const
	Return a bool indicating whether the compression level for this call has been set (either implicitly or through a previous call to set_compression_level. More...

grpc_compression_algorithm	compression_algorithm () const
	Return the compression algorithm the server call will request be used. More...

void	set_compression_algorithm (grpc_compression_algorithm algorithm)
	Set algorithm to be the compression algorithm used for the server call. More...

void	SetLoadReportingCosts (const std::vector< grpc::string > &cost_data)
	Set the load reporting costs in cost_data for the call. More...

std::shared_ptr< const AuthContext >	auth_context () const
	Return the authentication context for this server call. More...

grpc::string	peer () const
	Return the peer uri in a string. More...

const struct census_context *	census_context () const
	Get the census context associated with this server call. More...

void	AsyncNotifyWhenDone (void *tag)
	Async only. More...

grpc_call *	c_call ()
	Should be used for framework-level extensions only. More...

Friends
class	::grpc::testing::InteropServerContextInspector

class	::grpc::testing::ServerContextTestSpouse

class	::grpc::ServerInterface

class	::grpc::Server

template<class W , class R >
class	::grpc::ServerAsyncReader

template<class W >
class	::grpc::ServerAsyncWriter

template<class W >
class	::grpc::ServerAsyncResponseWriter

template<class W , class R >
class	::grpc::ServerAsyncReaderWriter

template<class R >
class	::grpc::ServerReader

template<class W >
class	::grpc::ServerWriter

template<class W , class R >
class	::grpc::internal::ServerReaderWriterBody

template<class ServiceType , class RequestType , class ResponseType >
class	::grpc::internal::RpcMethodHandler

template<class ServiceType , class RequestType , class ResponseType >
class	::grpc::internal::ClientStreamingHandler

template<class ServiceType , class RequestType , class ResponseType >
class	::grpc::internal::ServerStreamingHandler

template<class Streamer , bool WriteNeeded>
class	::grpc::internal::TemplatedBidiStreamingHandler

class	::grpc::internal::UnknownMethodHandler

class	::grpc::ClientContext

Detailed Description

A ServerContext allows the person implementing a service handler to:

Add custom initial and trailing metadata key-value pairs that will propagated to the client side.
Control call settings such as compression and authentication.
Access metadata coming from the client.
Get performance metrics (ie, census).

Context settings are only relevant to the call handler they are supplied to, that is to say, they aren't sticky across multiple calls. Some of these settings, such as the compression options, can be made persistent at server construction time by specifying the appropriate ChannelArguments to a grpc::ServerBuilder, via ServerBuilder::AddChannelArgument.

Warning: ServerContext instances should not be reused across rpcs.

Constructor & Destructor Documentation

◆ ServerContext()

grpc::ServerContext::ServerContext ( )

◆ ~ServerContext()

grpc::ServerContext::~ServerContext ( )

Member Function Documentation

◆ AddInitialMetadata()

void grpc::ServerContext::AddInitialMetadata	(	const grpc::string &	key,
		const grpc::string &	value
	)

Add the (meta_key, meta_value) pair to the initial metadata associated with a server call.

These are made available at the client side by the grpc::ClientContext::GetServerInitialMetadata() method.

Warning: This method should only be called before sending initial metadata to the client (which can happen explicitly, or implicitly when sending a a response message or status to the client).

Parameters

meta_key	The metadata key. If meta_value is binary data, it must end in "-bin".
meta_value	The metadata value. If its value is binary, the key name must end in "-bin".

◆ AddTrailingMetadata()

void grpc::ServerContext::AddTrailingMetadata	(	const grpc::string &	key,
		const grpc::string &	value
	)

Add the (meta_key, meta_value) pair to the initial metadata associated with a server call.

These are made available at the client side by the grpc::ClientContext::GetServerTrailingMetadata() method.

Warning: This method should only be called before sending trailing metadata to the client (which happens when the call is finished and a status is sent to the client).

Parameters

meta_key	The metadata key. If meta_value is binary data, it must end in "-bin".
meta_value	The metadata value. If its value is binary, the key name must end in "-bin".

◆ AsyncNotifyWhenDone()

void grpc::ServerContext::AsyncNotifyWhenDone ( void * tag )

inline

Async only.

Has to be called before the rpc starts. Returns the tag in completion queue when the rpc finishes. IsCancelled() can then be called to check whether the rpc was cancelled.

◆ auth_context()

std::shared_ptr<const AuthContext> grpc::ServerContext::auth_context ( ) const

inline

Return the authentication context for this server call.

See also: grpc::AuthContext.

◆ c_call()

grpc_call* grpc::ServerContext::c_call ( )

inline

Should be used for framework-level extensions only.

Applications never need to call this method.

◆ census_context()

const struct census_context* grpc::ServerContext::census_context ( ) const

Get the census context associated with this server call.

◆ client_metadata()

const std::multimap<grpc::string_ref, grpc::string_ref>& grpc::ServerContext::client_metadata ( ) const

inline

Return a collection of initial metadata key-value pairs sent from the client.

Note that keys may happen more than once (ie, a std::multimap is returned).

It is safe to use this method after initial metadata has been received, Calls always begin with the client sending initial metadata, so this is safe to access as soon as the call has begun on the server side.

Returns: A multimap of initial metadata key-value pairs from the server.

◆ compression_algorithm()

grpc_compression_algorithm grpc::ServerContext::compression_algorithm ( ) const

inline

Return the compression algorithm the server call will request be used.

Note that the gRPC runtime may decide to ignore this request, for example, due to resource constraints, or if the server is aware the client doesn't support the requested algorithm.

◆ compression_level()

grpc_compression_level grpc::ServerContext::compression_level ( ) const

inline

Return the compression algorithm to be used by the server call.

◆ compression_level_set()

bool grpc::ServerContext::compression_level_set ( ) const

inline

Return a bool indicating whether the compression level for this call has been set (either implicitly or through a previous call to set_compression_level.

◆ deadline()

std::chrono::system_clock::time_point grpc::ServerContext::deadline ( ) const

inline

Return the deadline for the server call.

◆ IsCancelled()

bool grpc::ServerContext::IsCancelled ( ) const

IsCancelled is always safe to call when using sync API.

When using async API, it is only safe to call IsCancelled after the AsyncNotifyWhenDone tag has been delivered.

◆ peer()

grpc::string grpc::ServerContext::peer ( ) const

Return the peer uri in a string.

WARNING: this value is never authenticated or subject to any security related code. It must not be used for any authentication related functionality. Instead, use auth_context.

◆ raw_deadline()

gpr_timespec grpc::ServerContext::raw_deadline ( ) const

inline

Return a gpr_timespec representation of the server call's deadline.

◆ set_compression_algorithm()

void grpc::ServerContext::set_compression_algorithm ( grpc_compression_algorithm algorithm )

Set algorithm to be the compression algorithm used for the server call.

Parameters

algorithm The compression algorithm used for the server call.

◆ set_compression_level()

void grpc::ServerContext::set_compression_level ( grpc_compression_level level )

inline

Set algorithm to be the compression algorithm used for the server call.

Parameters

algorithm The compression algorithm used for the server call.

◆ SetLoadReportingCosts()

void grpc::ServerContext::SetLoadReportingCosts ( const std::vector< grpc::string > & cost_data )

Set the load reporting costs in cost_data for the call.

◆ TryCancel()

void grpc::ServerContext::TryCancel ( ) const

Cancel the Call from the server.

This is a best-effort API and depending on when it is called, the RPC may still appear successful to the client. For example, if TryCancel() is called on a separate thread, it might race with the server handler which might return success to the client before TryCancel() was even started by the thread.

It is the caller's responsibility to prevent such races and ensure that if TryCancel() is called, the serverhandler must return Status::CANCELLED. The only exception is that if the serverhandler is already returning an error status code, it is ok to not return Status::CANCELLED even if TryCancel() was called.

Note that TryCancel() does not change any of the tags that are pending on the completion queue. All pending tags will still be delivered (though their ok result may reflect the effect of cancellation).

Friends And Related Function Documentation

◆ ::grpc::ClientContext

friend class ::grpc::ClientContext

friend

◆ ::grpc::internal::ClientStreamingHandler

template<class ServiceType , class RequestType , class ResponseType >

friend class ::grpc::internal::ClientStreamingHandler

friend

◆ ::grpc::internal::RpcMethodHandler

template<class ServiceType , class RequestType , class ResponseType >

friend class ::grpc::internal::RpcMethodHandler

friend

◆ ::grpc::internal::ServerReaderWriterBody

template<class W , class R >

friend class ::grpc::internal::ServerReaderWriterBody

friend

◆ ::grpc::internal::ServerStreamingHandler

template<class ServiceType , class RequestType , class ResponseType >

friend class ::grpc::internal::ServerStreamingHandler

friend

◆ ::grpc::internal::TemplatedBidiStreamingHandler

template<class Streamer , bool WriteNeeded>

friend class ::grpc::internal::TemplatedBidiStreamingHandler

friend

◆ ::grpc::internal::UnknownMethodHandler

friend class ::grpc::internal::UnknownMethodHandler

friend

◆ ::grpc::Server

friend class ::grpc::Server

friend

◆ ::grpc::ServerAsyncReader

template<class W , class R >

friend class ::grpc::ServerAsyncReader

friend

◆ ::grpc::ServerAsyncReaderWriter

template<class W , class R >

friend class ::grpc::ServerAsyncReaderWriter

friend

◆ ::grpc::ServerAsyncResponseWriter

template<class W >

friend class ::grpc::ServerAsyncResponseWriter

friend

◆ ::grpc::ServerAsyncWriter

template<class W >

friend class ::grpc::ServerAsyncWriter

friend

◆ ::grpc::ServerInterface

friend class ::grpc::ServerInterface

friend

◆ ::grpc::ServerReader

template<class R >

friend class ::grpc::ServerReader

friend

◆ ::grpc::ServerWriter

template<class W >

friend class ::grpc::ServerWriter

friend

◆ ::grpc::testing::InteropServerContextInspector

friend class ::grpc::testing::InteropServerContextInspector

friend

◆ ::grpc::testing::ServerContextTestSpouse

friend class ::grpc::testing::ServerContextTestSpouse

friend

The documentation for this class was generated from the following file:

include/grpcpp/impl/codegen/server_context.h

Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ ServerContext()

◆ ~ServerContext()

Member Function Documentation

◆ AddInitialMetadata()

◆ AddTrailingMetadata()

◆ AsyncNotifyWhenDone()

◆ auth_context()

◆ c_call()

◆ census_context()

◆ client_metadata()

◆ compression_algorithm()

◆ compression_level()

◆ compression_level_set()

◆ deadline()

◆ IsCancelled()

◆ peer()

◆ raw_deadline()

◆ set_compression_algorithm()

◆ set_compression_level()

◆ SetLoadReportingCosts()

◆ TryCancel()

Friends And Related Function Documentation

◆ ::grpc::ClientContext

◆ ::grpc::internal::ClientStreamingHandler

◆ ::grpc::internal::RpcMethodHandler

◆ ::grpc::internal::ServerReaderWriterBody

◆ ::grpc::internal::ServerStreamingHandler

◆ ::grpc::internal::TemplatedBidiStreamingHandler

◆ ::grpc::internal::UnknownMethodHandler

◆ ::grpc::Server

◆ ::grpc::ServerAsyncReader

◆ ::grpc::ServerAsyncReaderWriter

◆ ::grpc::ServerAsyncResponseWriter

◆ ::grpc::ServerAsyncWriter

◆ ::grpc::ServerInterface

◆ ::grpc::ServerReader

◆ ::grpc::ServerWriter

◆ ::grpc::testing::InteropServerContextInspector

◆ ::grpc::testing::ServerContextTestSpouse