pub struct InterceptorContext<I = Input, O = Output, E = Error> { /* private fields */ }
Expand description
A container for the data currently available to an interceptor.
Different context is available based on which phase the operation is currently in. For example,
context in the “before serialization” phase won’t have a request
yet since the input hasn’t been
serialized at that point. But once it gets into the “before transmit” phase, the request
will be set.
Implementations§
Source§impl InterceptorContext
impl InterceptorContext
Sourcepub fn new(input: Input) -> InterceptorContext
pub fn new(input: Input) -> InterceptorContext
Creates a new interceptor context in the “before serialization” phase.
Source§impl<I, O, E> InterceptorContext<I, O, E>
impl<I, O, E> InterceptorContext<I, O, E>
Sourcepub fn input(&self) -> Option<&I>
pub fn input(&self) -> Option<&I>
Retrieve the input for the operation being invoked.
Note: This method is intended for internal use only.
Sourcepub fn input_mut(&mut self) -> Option<&mut I>
pub fn input_mut(&mut self) -> Option<&mut I>
Retrieve the input for the operation being invoked.
Note: This method is intended for internal use only.
Sourcepub fn take_input(&mut self) -> Option<I>
pub fn take_input(&mut self) -> Option<I>
Takes ownership of the input.
Note: This method is intended for internal use only.
Sourcepub fn set_request(&mut self, request: Request)
pub fn set_request(&mut self, request: Request)
Set the request for the operation being invoked.
Note: This method is intended for internal use only.
Sourcepub fn request(&self) -> Option<&Request>
pub fn request(&self) -> Option<&Request>
Retrieve the transmittable request for the operation being invoked. This will only be available once request marshalling has completed.
Note: This method is intended for internal use only.
Sourcepub fn request_mut(&mut self) -> Option<&mut Request>
pub fn request_mut(&mut self) -> Option<&mut Request>
Retrieve the transmittable request for the operation being invoked. This will only be available once request marshalling has completed.
Note: This method is intended for internal use only.
Sourcepub fn take_request(&mut self) -> Option<Request>
pub fn take_request(&mut self) -> Option<Request>
Takes ownership of the request.
Note: This method is intended for internal use only.
Sourcepub fn set_response(&mut self, response: Response)
pub fn set_response(&mut self, response: Response)
Set the response for the operation being invoked.
Note: This method is intended for internal use only.
Sourcepub fn response(&self) -> Option<&Response>
pub fn response(&self) -> Option<&Response>
Returns the response.
Note: This method is intended for internal use only.
Sourcepub fn response_mut(&mut self) -> Option<&mut Response>
pub fn response_mut(&mut self) -> Option<&mut Response>
Returns a mutable reference to the response.
Note: This method is intended for internal use only.
Sourcepub fn set_output_or_error(&mut self, output: Result<O, OrchestratorError<E>>)
pub fn set_output_or_error(&mut self, output: Result<O, OrchestratorError<E>>)
Set the output or error for the operation being invoked.
Note: This method is intended for internal use only.
Sourcepub fn output_or_error(&self) -> Option<Result<&O, &OrchestratorError<E>>>
pub fn output_or_error(&self) -> Option<Result<&O, &OrchestratorError<E>>>
Returns the deserialized output or error.
Note: This method is intended for internal use only.
Sourcepub fn output_or_error_mut(
&mut self,
) -> Option<&mut Result<O, OrchestratorError<E>>>
pub fn output_or_error_mut( &mut self, ) -> Option<&mut Result<O, OrchestratorError<E>>>
Returns the mutable reference to the deserialized output or error.
Note: This method is intended for internal use only.
Sourcepub fn is_failed(&self) -> bool
pub fn is_failed(&self) -> bool
Return true
if this context’s output_or_error
is an error. Otherwise, return false
.
Note: This method is intended for internal use only.
Sourcepub fn enter_serialization_phase(&mut self)
pub fn enter_serialization_phase(&mut self)
Advance to the Serialization phase.
Note: This method is intended for internal use only.
Sourcepub fn enter_before_transmit_phase(&mut self)
pub fn enter_before_transmit_phase(&mut self)
Advance to the BeforeTransmit phase.
Note: This method is intended for internal use only.
Sourcepub fn enter_transmit_phase(&mut self)
pub fn enter_transmit_phase(&mut self)
Advance to the Transmit phase.
Note: This method is intended for internal use only.
Sourcepub fn enter_before_deserialization_phase(&mut self)
pub fn enter_before_deserialization_phase(&mut self)
Advance to the BeforeDeserialization phase.
Note: This method is intended for internal use only.
Sourcepub fn enter_deserialization_phase(&mut self)
pub fn enter_deserialization_phase(&mut self)
Advance to the Deserialization phase.
Note: This method is intended for internal use only.
Sourcepub fn enter_after_deserialization_phase(&mut self)
pub fn enter_after_deserialization_phase(&mut self)
Advance to the AfterDeserialization phase.
Note: This method is intended for internal use only.
Sourcepub fn save_checkpoint(&mut self)
pub fn save_checkpoint(&mut self)
Set the request checkpoint. This should only be called once, right before entering the retry loop.
Note: This method is intended for internal use only.
Sourcepub fn rewind(&mut self, _cfg: &mut ConfigBag) -> RewindResult
pub fn rewind(&mut self, _cfg: &mut ConfigBag) -> RewindResult
Returns false if rewinding isn’t possible
Note: This method is intended for internal use only.
Source§impl<I, O, E> InterceptorContext<I, O, E>where
E: Debug,
impl<I, O, E> InterceptorContext<I, O, E>where
E: Debug,
Sourcepub fn into_parts(
self,
) -> (Option<I>, Option<Result<O, OrchestratorError<E>>>, Option<Request>, Option<Response>)
pub fn into_parts( self, ) -> (Option<I>, Option<Result<O, OrchestratorError<E>>>, Option<Request>, Option<Response>)
Decomposes the context into its constituent parts.
Note: This method is intended for internal use only.
Sourcepub fn finalize(self) -> Result<O, SdkError<E, Response>>
pub fn finalize(self) -> Result<O, SdkError<E, Response>>
Convert this context into the final operation result that is returned in client’s the public API.
Note: This method is intended for internal use only.
Sourcepub fn fail(&mut self, error: OrchestratorError<E>)
pub fn fail(&mut self, error: OrchestratorError<E>)
Mark this context as failed due to errors during the operation. Any errors already contained by the context will be replaced by the given error.
Note: This method is intended for internal use only.