Struct ChainHooks 

pub struct ChainHooks { /* private fields */ }

Several Hooks as one. Gates, starts and retries run in order; ends run in reverse, so a hook that wraps the ones after it closes last, the way nested spans do.

Implementations

impl ChainHooks

pub fn of(hooks: Vec<Arc<dyn Hooks>>) -> Arc<dyn Hooks>

Chains what is left once the no-ops are dropped. Nothing left is a NoopHooks, and one left is that hook itself — a chain of one is just the hook, which is why this answers some Hooks rather than always a ChainHooks.

Trait Implementations

impl Hooks for ChainHooks

fn on_operation_gate<'life0, 'life1, 'async_trait>( &'life0 self, op: &'life1 OperationInfo, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Asks every member in order and answers the first refusal. Go asks only the first member that implements its separate gating interface; here gating is part of Hooks itself, so the chain stops at whichever member refuses.

fn on_operation_start(&self, op: &OperationInfo) -> OperationState

Keeps each member’s own state, so ChainHooks::on_operation_end can hand every one of them back what it made.

fn on_operation_end( &self, op: &OperationInfo, state: OperationState, outcome: Result<(), &Error>, duration: Duration, )

Told how the operation ended and how long the whole of it took, requests, waits and all.

fn on_request_start(&self, info: &RequestInfo)

Told one HTTP request is about to go out.

fn on_request_end(&self, info: &RequestInfo, result: &RequestResult<'_>)

Told how one HTTP request turned out, once its body has been dealt with.

fn on_retry(&self, info: &RequestInfo, next_attempt: u32, cause: &Error)

Told about a resend before it is made: the attempt that failed in info, the one about to be made as next_attempt, and what prompted it.

fn is_noop(&self) -> bool

Answers true when this implementation does nothing, so ChainHooks can leave it out.