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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! Response headers and content types
//!
//! Run: cargo run --example 12_response_headers
//! Test: curl -i http://localhost:3000/api/json

use route_controller::{controller, get, post};
use serde::Serialize;

#[derive(Serialize)]
struct ApiResponse {
  message: String,
}

struct ApiController;

// Controller-level headers apply to all routes
// Route-level headers override controller-level headers
#[controller(
  path = "/api",
  header("x-api-version", "1.0"),
  header("x-powered-by", "route-controller")
)]
impl ApiController {
  // Inherits controller headers: x-api-version=1.0, x-powered-by=route-controller
  #[get("/json")]
  async fn json_response() -> axum::Json<ApiResponse> {
    axum::Json(ApiResponse {
      message: "Response with controller headers".to_string(),
    })
  }

  // Route-level header overrides controller's x-api-version
  #[get(
    "/multi",
    header("x-api-version", "2.0"),
    header("x-request-id", "abc-123")
  )]
  async fn multi_headers() -> &'static str {
    "Route header overrides controller header (x-api-version=2.0)"
  }

  // Custom content type inherits controller headers
  #[get("/xml", content_type("application/xml"))]
  async fn xml_response() -> String {
    r#"<?xml version="1.0"?><response><message>Hello XML</message></response>"#.to_string()
  }

  // Content type with custom headers
  #[post(
    "/data",
    content_type("application/json"),
    header("x-api-version", "3.0")
  )]
  async fn data_with_headers() -> axum::Json<ApiResponse> {
    axum::Json(ApiResponse {
      message: "Data with content type and headers".to_string(),
    })
  }
}

#[tokio::main]
async fn main() {
  let app = ApiController::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 (note -i to see headers):");
  println!("  curl -i http://localhost:3000/api/json");
  println!("    -> Should see: x-api-version: 1.0, x-powered-by: route-controller");
  println!("  curl -i http://localhost:3000/api/multi");
  println!("    -> Should see: x-api-version: 2.0 (overridden), x-request-id: abc-123");
  println!("  curl -i http://localhost:3000/api/xml");
  println!("    -> Should see: content-type: application/xml, controller headers");
  println!("  curl -i -X POST http://localhost:3000/api/data");
  println!("    -> Should see: x-api-version: 3.0 (overridden), content-type: application/json");

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