route_controller 0.2.0

A procedural macro for generating Axum routers from controller-style implementations with support for route prefixing and middleware
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! Multiple controllers with merged routers
//!
//! Run: cargo run --example 15_multiple_controllers
//! Test: curl http://localhost:3000/users and curl http://localhost:3000/posts

use route_controller::{controller, get};

struct UserController;

#[controller(path = "/users")]
impl UserController {
  #[get]
  async fn list() -> &'static str {
    "User list"
  }

  #[get("/{id}", extract(id = Path))]
  async fn get(id: u32) -> String {
    format!("User {}", id)
  }
}

struct PostController;

#[controller(path = "/posts")]
impl PostController {
  #[get]
  async fn list() -> &'static str {
    "Post list"
  }

  #[get("/{id}", extract(id = Path))]
  async fn get(id: u32) -> String {
    format!("Post {}", id)
  }
}

#[tokio::main]
async fn main() {
  // Merge multiple controllers
  let app = axum::Router::new()
    .merge(UserController::router())
    .merge(PostController::router());

  let listener = tokio::net::TcpListener::bind("127.0.0.1:3000")
    .await
    .unwrap();

  println!("🚀 Server running on http://127.0.0.1:3000");
  println!("\nTry:");
  println!("  curl http://localhost:3000/users");
  println!("  curl http://localhost:3000/users/1");
  println!("  curl http://localhost:3000/posts");
  println!("  curl http://localhost:3000/posts/1");

  axum::serve(listener, app).await.unwrap();
}