/rust/registry/src/index.crates.io-1949cf8c6b5b557f/axum-0.8.9/src/service_ext.rs

Source
use crate::error_handling::HandleError;
#[cfg(feature = "tokio")]
use crate::extract::connect_info::IntoMakeServiceWithConnectInfo;
use crate::routing::IntoMakeService;
use tower_service::Service;

/// Extension trait that adds additional methods to any [`Service`].
pub trait ServiceExt<R>: Service<R> + Sized {
    /// Convert this service into a [`MakeService`], that is a [`Service`] whose
    /// response is another service.
    ///
    /// This is commonly used when applying middleware around an entire [`Router`]. See ["Rewriting
    /// request URI in middleware"] for more details.
    ///
    /// [`MakeService`]: tower::make::MakeService
    /// ["Rewriting request URI in middleware"]: crate::middleware#rewriting-request-uri-in-middleware
    /// [`Router`]: crate::Router
    fn into_make_service(self) -> IntoMakeService<Self>;

    /// Convert this service into a [`MakeService`], that will store `C`'s
    /// associated `ConnectInfo` in a request extension such that [`ConnectInfo`]
    /// can extract it.
    ///
    /// This enables extracting things like the client's remote address.
    /// This is commonly used when applying middleware around an entire [`Router`]. See ["Rewriting
    /// request URI in middleware"] for more details.
    ///
    /// [`MakeService`]: tower::make::MakeService
    /// ["Rewriting request URI in middleware"]: crate::middleware#rewriting-request-uri-in-middleware
    /// [`Router`]: crate::Router
    /// [`ConnectInfo`]: crate::extract::connect_info::ConnectInfo
    #[cfg(feature = "tokio")]
    fn into_make_service_with_connect_info<C>(self) -> IntoMakeServiceWithConnectInfo<Self, C>;

    /// Convert this service into a [`HandleError`], that will handle errors
    /// by converting them into responses.
    ///
    ///  See ["error handling model"] for more details.
    ///
    /// [`HandleError`]: crate::error_handling::HandleError
    /// ["error handling model"]: crate::error_handling#axums-error-handling-model
    fn handle_error<F, T>(self, f: F) -> HandleError<Self, F, T> {
        HandleError::new(self, f)
    }
}

impl<S, R> ServiceExt<R> for S
where
    S: Service<R> + Sized,
{
    fn into_make_service(self) -> IntoMakeService<Self> {
        IntoMakeService::new(self)
    }

    #[cfg(feature = "tokio")]
    fn into_make_service_with_connect_info<C>(self) -> IntoMakeServiceWithConnectInfo<Self, C> {
        IntoMakeServiceWithConnectInfo::new(self)
    }
}

Coverage Report

Created: 2026-07-13 08:11

Line	Count	Source
1		use crate::error_handling::HandleError;
2		#[cfg(feature = "tokio")]
3		use crate::extract::connect_info::IntoMakeServiceWithConnectInfo;
4		use crate::routing::IntoMakeService;
5		use tower_service::Service;
6
7		/// Extension trait that adds additional methods to any [`Service`].
8		pub trait ServiceExt<R>: Service<R> + Sized {
9		/// Convert this service into a [`MakeService`], that is a [`Service`] whose
10		/// response is another service.
11		///
12		/// This is commonly used when applying middleware around an entire [`Router`]. See ["Rewriting
13		/// request URI in middleware"] for more details.
14		///
15		/// [`MakeService`]: tower::make::MakeService
16		/// ["Rewriting request URI in middleware"]: crate::middleware#rewriting-request-uri-in-middleware
17		/// [`Router`]: crate::Router
18		fn into_make_service(self) -> IntoMakeService<Self>;
19
20		/// Convert this service into a [`MakeService`], that will store `C`'s
21		/// associated `ConnectInfo` in a request extension such that [`ConnectInfo`]
22		/// can extract it.
23		///
24		/// This enables extracting things like the client's remote address.
25		/// This is commonly used when applying middleware around an entire [`Router`]. See ["Rewriting
26		/// request URI in middleware"] for more details.
27		///
28		/// [`MakeService`]: tower::make::MakeService
29		/// ["Rewriting request URI in middleware"]: crate::middleware#rewriting-request-uri-in-middleware
30		/// [`Router`]: crate::Router
31		/// [`ConnectInfo`]: crate::extract::connect_info::ConnectInfo
32		#[cfg(feature = "tokio")]
33		fn into_make_service_with_connect_info<C>(self) -> IntoMakeServiceWithConnectInfo<Self, C>;
34
35		/// Convert this service into a [`HandleError`], that will handle errors
36		/// by converting them into responses.
37		///
38		/// See ["error handling model"] for more details.
39		///
40		/// [`HandleError`]: crate::error_handling::HandleError
41		/// ["error handling model"]: crate::error_handling#axums-error-handling-model
42	0	fn handle_error<F, T>(self, f: F) -> HandleError<Self, F, T> {
43	0	HandleError::new(self, f)
44	0	}
45		}
46
47		impl<S, R> ServiceExt<R> for S
48		where
49		S: Service<R> + Sized,
50		{
51	0	fn into_make_service(self) -> IntoMakeService<Self> {
52	0	IntoMakeService::new(self)
53	0	}
54
55		#[cfg(feature = "tokio")]
56		fn into_make_service_with_connect_info<C>(self) -> IntoMakeServiceWithConnectInfo<Self, C> {
57		IntoMakeServiceWithConnectInfo::new(self)
58		}
59		}