Crate springtime_web_axum

Web framework based on Springtime and axum.

axum is a web application framework built with a imperative approach - integration with Springtime allows for declarative approach to creating handlers (called here Controllers) which can take full advantage of dependency injection.

Simple usage example

use axum::extract::Path;
use springtime::application;
use springtime_di::Component;
use springtime_web_axum::controller;

// create a struct which will serve as our Controller - this implies it
// needs to be a Component for the dependency injection to work
#[derive(Component)]
struct ExampleController;

// mark the struct as a Controller - this will scan all functions for the
// controller attributes and create axum handlers out of them
#[controller]
impl ExampleController {
    // this function will respond to GET request for http://localhost/ (or
    // any network interface)
    #[get("/")]
    async fn hello_world(&self) -> &'static str {
        "Hello world!"
    }
}

// note: for the sake of simplicity, errors are unwrapped, rather than
// gracefully handled
#[tokio::main]
async fn main() {
    let mut application =
        application::create_default().expect("unable to create application");

    // run our server with default configuration - requests should be
    // forwarded to ExampleController
    application.run().await.expect("error running application");
}

Features

• derive - automatically import helper proc macros

Re-exports

• pub use axum;

Modules

• config
  Framework configuration is based on injecting an WebConfigProvider, which can later be used to retrieve WebConfig.
• controller
  Functionality related to defining Controllers - containers for functions which handle web requests.
• router
  Controller routing handling. By default, routing is based on gathering existing controllers and their request handlers.
• server
  Core server-related functionality.

Attribute Macros

• controller