Struct mz_service::grpc::GrpcServer

pub struct GrpcServer<F> { /* private fields */ }

Expand description

A gRPC server that stitches a gRPC service with a single bidirectional stream to a GenericClient.

It is the counterpart of GrpcClient.

To use, implement the tonic-generated ProtoService trait for this type. The implementation of the bidirectional stream method should call GrpcServer::forward_bidi_stream to stitch the bidirectional stream to the client underlying this server.

Implementations§

impl<F, G> GrpcServer<F>
where F: Fn() -> G + Send + Sync + 'static,

pub async fn serve<S, Fs>( listen_addr: SocketAddr, version: Version, client_builder: F, service_builder: Fs ) -> Result<(), Error>
where S: Service<Request<Body>, Response = Response<BoxBody>, Error = Infallible> + NamedService + Clone + Send + 'static, S::Future: Send + 'static, Fs: FnOnce(Self) -> S + Send + 'static,

Starts the server, listening for gRPC connections on listen_addr.

The trait bounds on S are intimidating, but it is the return type of service_builder, which is a function that turns a GrpcServer<ProtoCommandType, ProtoResponseType> into a Service that represents a gRPC server. This is always encapsulated by the tonic-generated ProtoServer::new method for a specific Protobuf service.

pub async fn forward_bidi_stream<C, R, PC, PR>( &self, request: Request<Streaming<PC>> ) -> Result<Response<ResponseStream<PR>>, Status>
where G: GenericClient<C, R> + 'static, C: RustType<PC> + Send + Sync + 'static + Debug, R: RustType<PR> + Send + Sync + 'static + Debug, PC: Debug + Send + Sync + 'static, PR: Debug + Send + Sync + 'static,

Handles a bidirectional stream request by forwarding commands to and responses from the server’s underlying client.

Call this method from the implementation of the tonic-generated ProtoService.

Auto Trait Implementations§

impl<F> Freeze for GrpcServer<F>

impl<F> !RefUnwindSafe for GrpcServer<F>

impl<F> Send for GrpcServer<F>
where F: Sync + Send,

impl<F> Sync for GrpcServer<F>
where F: Sync + Send,

impl<F> Unpin for GrpcServer<F>

impl<F> !UnwindSafe for GrpcServer<F>

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T, U> CastInto<U> for T
where U: CastFrom<T>,

fn cast_into(self) -> U

Performs the cast.

impl<R, O, T> CopyOnto<ConsecutiveOffsetPairs<R, O>> for T
where R: Region<Index = (usize, usize)>, O: OffsetContainer<usize>, T: CopyOnto<R>,

fn copy_onto( self, target: &mut ConsecutiveOffsetPairs<R, O> ) -> <ConsecutiveOffsetPairs<R, O> as Region>::Index

Copy self into the target container, returning an index that allows to look up the corresponding read item.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FutureExt for T

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoRequest<T> for T

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.

impl<T, U> OverrideFrom<Option<&T>> for U
where U: OverrideFrom<T>,

fn override_from(self, layer: &Option<&T>) -> U

Override the configuration represented by Self with values from the given layer.

impl<T> Pointable for T

const ALIGN: usize = _

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<P, R> ProtoType<R> for P
where R: RustType<P>,

fn into_rust(self) -> Result<R, TryFromProtoError>

See RustType::from_proto.

fn from_rust(rust: &R) -> P

See RustType::into_proto.

impl<R, T> PushInto<FlatStack<R>> for T
where R: Region + Clone + 'static, T: CopyOnto<R>,

fn push_into(self, target: &mut FlatStack<R>)

Push self into the target container.

impl<T> PushInto<Vec<T>> for T

fn push_into(self, target: &mut Vec<T>)

Push self into the target container.

impl<T> Same for T

type Output = T

Should always be Self

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more