Struct AppInner 

pub struct AppInner { /* private fields */ }

The finalized application: shared state plus a compiled route matcher.

This is the value shared across all connections. It is cheap to clone behind an Arc and is what the server hands each request to via dispatch.

Implementations

impl AppInner

pub fn state(&self) -> &AppStateRef

Returns the shared application state.

pub fn matcher(&self) -> &Matcher

Returns the compiled route matcher.

pub fn begin_ws_shutdown(&self)

Signals in-flight WebSocket connections to close cleanly.

Called by the server when graceful shutdown begins; idempotent.

pub async fn handle(self: Arc<Self>, request: Request) -> Response

Runs the middleware chain and dispatches the request.

This is the entrypoint the server calls per request. on_request hooks run before the chain and on_response hooks run after it. The middleware chain wraps dispatch; a middleware error is rendered into a response (through the error hooks and any exception handler) so the connection is never torn down.

impl AppInner

pub async fn dispatch(&self, request: Request<ReqBody>) -> Response

Routes request to its handler and produces a response.

Routing failures (404/405) and a handler’s own errors are rendered here via render_error, so the error hooks and any exception handler run before rendering. This function never returns an error, so an application error never tears down the connection.