Struct LayeredServer 

pub struct LayeredServer<S> {
    pub service: S,
    /* private fields */
}

A server with Tower middleware layers applied.

Created by Server::layer. Supports further .layer() calls and .serve().

Fields

service: S

The layered service. Exposed for advanced use cases (e.g., manual serving).

Implementations

impl<S> LayeredServer<S>

pub fn with_state<T: Clone + Send + Sync + 'static>(self, state: T) -> Self

Add shared state accessible via State<T> extractors.

pub fn max_body_size(self, max: usize) -> Self

Set the maximum request body size.

pub fn nest(self, prefix: &str) -> Self

Set a path prefix for all routes.

pub fn with_static_files(self, prefix: &str, dir: impl Into<PathBuf>) -> Self

Serve static files from a directory.

pub fn with_spa_fallback(self, index_path: impl Into<PathBuf>) -> Self

Serve a file as SPA fallback for unmatched routes.

impl<S> LayeredServer<S>

where S: Service<Request<Incoming>, Response = Response<BoxBody>, Error = Infallible> + Clone + Send + 'static, S::Future: Send + 'static,

pub fn layer<L>(self, layer: L) -> LayeredServer<L::Service>

where L: Layer<S>, L::Service: Service<Request<Incoming>, Response = Response<BoxBody>, Error = Infallible> + Clone + Send + 'static, <L::Service as Service<Request<Incoming>>>::Future: Send + 'static,

Apply another Tower middleware layer.

pub async fn serve( self, addr: SocketAddr, ) -> Result<(), Box<dyn Error + Send + Sync>>

Start serving HTTP requests on the given address.

pub async fn serve_with_shutdown( self, listener: TcpListener, shutdown: impl Future<Output = ()> + Send, ) -> Result<(), Box<dyn Error + Send + Sync>>

Start serving with graceful shutdown.