pub struct GrpcTimeout<S> { /* private fields */ }Expand description
A Service that bounds how long the inner service has to answer a gRPC request.
A gRPC client states its deadline in the grpc-timeout request header. Enforcing it server-side means a request
the caller has already given up on stops consuming resources, rather than running to completion so its response can
be discarded.
A request without the header, or with a header that doesn’t parse, is passed through with no deadline. Silently ignoring a malformed value is what the gRPC specification calls for: a deadline the server can’t read is not grounds for rejecting the request.
An expired deadline is answered with DEADLINE_EXCEEDED, which is the code the specification assigns to it. Note
that tonic’s own timeout middleware answers with CANCELLED instead, an artifact of how it routes the expiry
through its generic error handling.
§Missing
There is no server-side maximum to bound a client that asks for an unreasonably long deadline, because nothing here needs one yet. Adding it means taking the shorter of the two durations.
Trait Implementations§
Source§impl<S: Clone> Clone for GrpcTimeout<S>
impl<S: Clone> Clone for GrpcTimeout<S>
Source§fn clone(&self) -> GrpcTimeout<S>
fn clone(&self) -> GrpcTimeout<S>
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl<S: Debug> Debug for GrpcTimeout<S>
impl<S: Debug> Debug for GrpcTimeout<S>
Source§impl<S, ReqBody, ResBody> Service<Request<ReqBody>> for GrpcTimeout<S>where
S: Service<Request<ReqBody>, Response = Response<ResBody>, Error = Infallible>,
ResBody: Default,
impl<S, ReqBody, ResBody> Service<Request<ReqBody>> for GrpcTimeout<S>where
S: Service<Request<ReqBody>, Response = Response<ResBody>, Error = Infallible>,
ResBody: Default,
Source§type Error = Infallible
type Error = Infallible
Source§type Future = GrpcTimeoutFuture<<S as Service<Request<ReqBody>>>::Future>
type Future = GrpcTimeoutFuture<<S as Service<Request<ReqBody>>>::Future>
impl<S: Copy> Copy for GrpcTimeout<S>
Auto Trait Implementations§
impl<S> Freeze for GrpcTimeout<S>where
S: Freeze,
impl<S> RefUnwindSafe for GrpcTimeout<S>where
S: RefUnwindSafe,
impl<S> Send for GrpcTimeout<S>where
S: Send,
impl<S> Sync for GrpcTimeout<S>where
S: Sync,
impl<S> Unpin for GrpcTimeout<S>where
S: Unpin,
impl<S> UnwindSafe for GrpcTimeout<S>where
S: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T, ReqBody, ResBody> GrpcService<ReqBody> for T
impl<T, ReqBody, ResBody> GrpcService<ReqBody> for T
Source§type ResponseBody = ResBody
type ResponseBody = ResBody
Source§fn poll_ready(
&mut self,
cx: &mut Context<'_>,
) -> Poll<Result<(), <T as GrpcService<ReqBody>>::Error>>
fn poll_ready( &mut self, cx: &mut Context<'_>, ) -> Poll<Result<(), <T as GrpcService<ReqBody>>::Error>>
Ready when the service is able to process requests. Read moreSource§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::RequestSource§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<S, R> ServiceExt<R> for Swhere
S: Service<R>,
impl<S, R> ServiceExt<R> for Swhere
S: Service<R>,
Source§fn into_make_service(self) -> IntoMakeService<S>
fn into_make_service(self) -> IntoMakeService<S>
MakeService, that is a Service whose
response is another service. Read moreSource§fn into_make_service_with_connect_info<C>(
self,
) -> IntoMakeServiceWithConnectInfo<S, C>
fn into_make_service_with_connect_info<C>( self, ) -> IntoMakeServiceWithConnectInfo<S, C>
MakeService, that will store C’s
associated ConnectInfo in a request extension such that ConnectInfo
can extract it. Read moreSource§fn handle_error<F, T>(self, f: F) -> HandleError<Self, F, T>
fn handle_error<F, T>(self, f: F) -> HandleError<Self, F, T>
HandleError, that will handle errors
by converting them into responses. Read moreSource§impl<T, Request> ServiceExt<Request> for T
impl<T, Request> ServiceExt<Request> for T
Source§fn ready(&mut self) -> Ready<'_, Self, Request>where
Self: Sized,
fn ready(&mut self) -> Ready<'_, Self, Request>where
Self: Sized,
Source§fn ready_oneshot(self) -> ReadyOneshot<Self, Request>where
Self: Sized,
fn ready_oneshot(self) -> ReadyOneshot<Self, Request>where
Self: Sized,
Source§fn oneshot(self, req: Request) -> Oneshot<Self, Request>where
Self: Sized,
fn oneshot(self, req: Request) -> Oneshot<Self, Request>where
Self: Sized,
Service, calling it with the provided request once it is ready.Source§fn and_then<F>(self, f: F) -> AndThen<Self, F>
fn and_then<F>(self, f: F) -> AndThen<Self, F>
poll_ready method. Read moreSource§fn map_response<F, Response>(self, f: F) -> MapResponse<Self, F>
fn map_response<F, Response>(self, f: F) -> MapResponse<Self, F>
poll_ready method. Read moreSource§fn map_err<F, Error>(self, f: F) -> MapErr<Self, F>
fn map_err<F, Error>(self, f: F) -> MapErr<Self, F>
poll_ready method. Read moreSource§fn map_result<F, Response, Error>(self, f: F) -> MapResult<Self, F>
fn map_result<F, Response, Error>(self, f: F) -> MapResult<Self, F>
Result<Self::Response, Self::Error>)
to a different value, regardless of whether the future succeeds or
fails. Read moreSource§fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F>
fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F>
Source§fn filter_async<F, NewRequest>(self, filter: F) -> AsyncFilter<Self, F>where
Self: Sized,
F: AsyncPredicate<NewRequest>,
fn filter_async<F, NewRequest>(self, filter: F) -> AsyncFilter<Self, F>where
Self: Sized,
F: AsyncPredicate<NewRequest>,
AsyncFilter that conditionally accepts or
rejects requests based on an [async predicate]. Read moreSource§fn then<F, Response, Error, Fut>(self, f: F) -> Then<Self, F>
fn then<F, Response, Error, Fut>(self, f: F) -> Then<Self, F>
Source§fn map_future<F, Fut, Response, Error>(self, f: F) -> MapFuture<Self, F>
fn map_future<F, Fut, Response, Error>(self, f: F) -> MapFuture<Self, F>
Source§impl<T> Track for T
impl<T> Track for T
Source§fn track_resources(self, token: ResourceGroupToken) -> Tracked<Self>
fn track_resources(self, token: ResourceGroupToken) -> Tracked<Self>
Tracked wrapper. Read moreSource§fn in_current_resource_group(self) -> Tracked<Self>
fn in_current_resource_group(self) -> Tracked<Self>
Tracked wrapper. Read more