Struct App 

pub struct App {}

The built-in HTTP application. Serves static files, favicons, forms, file uploads, health probes, metrics, and a 404 fallback.

Use as-is or compose with the framework’s building blocks:

use rust_web_server::app::App;
use rust_web_server::middleware::{WithMiddleware, RateLimitLayer};
use rust_web_server::core::New;

// Middleware stack around the built-in app
let app = App::new().wrap(RateLimitLayer);

For user-defined routes with shared state, call App::with_state:

use rust_web_server::app::App;
use rust_web_server::response::{Response, STATUS_CODE_REASON_PHRASE};
use rust_web_server::core::New;

struct State { version: &'static str }

let app = App::with_state(State { version: "1.0" })
    .get("/version", |_req, _params, _conn, state| {
        let mut r = Response::new();
        r.status_code = *STATUS_CODE_REASON_PHRASE.n200_ok.status_code;
        r.reason_phrase = STATUS_CODE_REASON_PHRASE.n200_ok.reason_phrase.to_string();
        r
    });

Implementations

impl App

pub fn handle_request(request: Request) -> (Response, Request)

Dispatch request through the controller chain and return the response.

This is a convenience wrapper over Application::execute that uses a synthetic loopback ConnectionInfo. Use it in tests or when no real connection context is available. Prefer TestClient for structured test code.

pub fn with_state<S: Send + Sync + 'static>(state: S) -> AppWithState<S>

Create a state-aware application. Routes registered on the returned AppWithState<S> are tried first; unmatched requests fall through to the built-in controller chain (static files, health probes, etc.).

The state is stored as Arc<S> and shared across all handlers.

Example

use rust_web_server::app::App;
use rust_web_server::response::{Response, STATUS_CODE_REASON_PHRASE};
use rust_web_server::core::New;

struct Db { url: String }

let app = App::with_state(Db { url: "postgres://...".to_string() })
    .get("/ping", |_req, _params, _conn, db| {
        let mut r = Response::new();
        r.status_code = *STATUS_CODE_REASON_PHRASE.n200_ok.status_code;
        r.reason_phrase = STATUS_CODE_REASON_PHRASE.n200_ok.reason_phrase.to_string();
        r
    });

pub fn wrap<M: Middleware + 'static>(self, layer: M) -> WithMiddleware<App>

Wrap this application in a middleware layer.

Returns a WithMiddleware<App> that runs layer before every request. Chain .wrap() calls to stack multiple layers:

use rust_web_server::app::App;
use rust_web_server::middleware::RateLimitLayer;
use rust_web_server::core::New;

let app = App::new().wrap(RateLimitLayer);

Trait Implementations

impl Application for App

fn execute( &self, request: &Request, connection: &ConnectionInfo, ) -> Result<Response, String>

Receives a parsed request and returns a fully-built response. Walk your controller list with is_matching / process and return the first match.

impl Clone for App

fn clone(&self) -> App

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for App

impl New for App

fn new() -> Self