1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
use std::time::Duration;
use tracing::Span;
/// Trait used to tell [`Trace`] what to do when a body chunk has been sent.
///
/// See the [module docs](../trace/index.html#on_body_chunk) for details on exactly when the
/// `on_body_chunk` callback is called.
///
/// [`Trace`]: super::Trace
pub trait OnBodyChunk<B> {
/// Do the thing.
///
/// `latency` is the duration since the response was sent or since the last body chunk as sent.
///
/// `span` is the `tracing` [`Span`], corresponding to this request, produced by the closure
/// passed to [`TraceLayer::make_span_with`]. It can be used to [record field values][record]
/// that weren't known when the span was created.
///
/// [`Span`]: https://docs.rs/tracing/latest/tracing/span/index.html
/// [record]: https://docs.rs/tracing/latest/tracing/span/struct.Span.html#method.record
///
/// If you're using [hyper] as your server `B` will most likely be [`Bytes`].
///
/// [hyper]: https://hyper.rs
/// [`Bytes`]: https://docs.rs/bytes/latest/bytes/struct.Bytes.html
/// [`TraceLayer::make_span_with`]: crate::trace::TraceLayer::make_span_with
fn on_body_chunk(&mut self, chunk: &B, latency: Duration, span: &Span);
}
impl<B, F> OnBodyChunk<B> for F
where
F: FnMut(&B, Duration, &Span),
{
fn on_body_chunk(&mut self, chunk: &B, latency: Duration, span: &Span) {
self(chunk, latency, span)
}
}
impl<B> OnBodyChunk<B> for () {
#[inline]
fn on_body_chunk(&mut self, _: &B, _: Duration, _: &Span) {}
}
/// The default [`OnBodyChunk`] implementation used by [`Trace`].
///
/// Simply does nothing.
///
/// [`Trace`]: super::Trace
#[derive(Debug, Default, Clone)]
pub struct DefaultOnBodyChunk {
_priv: (),
}
impl DefaultOnBodyChunk {
/// Create a new `DefaultOnBodyChunk`.
pub fn new() -> Self {
Self { _priv: () }
}
}
impl<B> OnBodyChunk<B> for DefaultOnBodyChunk {
#[inline]
fn on_body_chunk(&mut self, _: &B, _: Duration, _: &Span) {}
}