Struct SendPushedResponse
pub struct SendPushedResponse<B: Buf> { /* private fields */ }
Send a response to a promised request
A SendPushedResponse instance is provided when promising a request and is used
to send the associated response to the client. It is also used to
explicitly reset the stream with a custom reason.
It can not be used to initiate push promises.
If the SendPushedResponse instance is dropped without sending a response, then
the HTTP/2 stream will be reset.
See module level docs for more details.
Implementations
impl<B: Buf> SendPushedResponse<B>
fn send_response(&mut self, response: Response<()>, end_of_stream: bool) -> Result<SendStream<B>, Error>Send a response to a promised request.
On success, a
SendStreaminstance is returned. This instance can be used to stream the response body and send trailers.If a body or trailers will be sent on the returned
SendStreaminstance, thenend_of_streammust be set tofalsewhen calling this function.The
SendPushedResponseinstance is associated with a promised request. This function may only be called once per instance and only ifsend_resethas not been previously called.fn send_reset(&mut self, reason: Reason)Send a stream reset to the peer.
This essentially cancels the stream, including any inbound or outbound data streams.
If this function is called before
send_response, a call tosend_responsewill result in an error.If this function is called while a
SendStreaminstance is active, any further use of the instance will result in an error.This function should only be called once.
fn poll_reset(&mut self, cx: &mut Context<'_>) -> Poll<Result<Reason, Error>>Polls to be notified when the client resets this stream.
If stream is still open, this returns
Poll::Pending, and registers the task to be notified if aRST_STREAMis received.If a
RST_STREAMframe is received for this stream, calling this method will yield theReasonfor the reset.Error
Calling this method after having called
send_responsewill return a user error.fn stream_id(&self) -> StreamIdReturns the stream ID of the response stream.
Panics
If the lock on the stream store has been poisoned.
Trait Implementations
impl<B: Buf + Debug> Debug for SendPushedResponse<B>
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Auto Trait Implementations
impl<B> Freeze for SendPushedResponse<B>
where
SendResponse<B>: Freeze,
impl<B> RefUnwindSafe for SendPushedResponse<B>
where
SendResponse<B>: RefUnwindSafe,
impl<B> Send for SendPushedResponse<B>
where
SendResponse<B>: Send,
impl<B> Sync for SendPushedResponse<B>
where
SendResponse<B>: Sync,
impl<B> Unpin for SendPushedResponse<B>
where
SendResponse<B>: Unpin,
impl<B> UnsafeUnpin for SendPushedResponse<B>
where
SendResponse<B>: UnsafeUnpin,
impl<B> UnwindSafe for SendPushedResponse<B>
where
SendResponse<B>: UnwindSafe,
Blanket Implementations
impl<T> Any for SendPushedResponse<B>
where
T: 'static + ?Sized,
fn type_id(&self) -> TypeId
impl<T> Borrow<T> for SendPushedResponse<B>
where
T: ?Sized,
fn borrow(&self) -> &T
impl<T> BorrowMut<T> for SendPushedResponse<B>
where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
impl<T> From<T> for SendPushedResponse<B>
fn from(t: T) -> TReturns the argument unchanged.
impl<T> Instrument for SendPushedResponse<B>
impl<T> WithSubscriber for SendPushedResponse<B>
impl<T, U> Into<U> for SendPushedResponse<B>
where
U: From<T>,
fn into(self) -> UCalls
U::from(self).That is, this conversion is whatever the implementation of
[From]<T> for Uchooses to do.
impl<T, U> TryFrom<U> for SendPushedResponse<B>
where
U: Into<T>,
type Error = never;fn try_from(value: U) -> Result<T, never>
impl<T, U> TryInto<U> for SendPushedResponse<B>
where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error;fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>