Rocket Request

GET

1. 添加 get 过程宏，并使用 <xxx>, 指定请求参数

   #[get("/hello/<name>/<age>/<cool>")]
   fn hello(name: &str, age: u8, cool: bool) -> String {
      if cool {
         format!("You're a cool {} year old, {}!", age, name)
      } else {
         format!("{}, we need to talk about your coolness.", name)
      }
   }
   
   

2. 通过 <xxx...>指定 list 参数

   use std::path::PathBuf;
   
   #[get("/page/<path..>")]
   fn get_page(path: PathBuf) { /* ... */ }
   

3. 通过 routes! ，注册路由

      rocket::build()
         .mount("/", routes![index])
         .mount("/base", routes![get_exs, get_ex, post_ex, put_ex, delete_ex])
   

POST

1. 添加 post 过程宏，并使用 data = <xxx>, 指定 body data。xxx 必须实现 FromData trait

   # [post("/", data = "<input>")]
   fn new(input: T) { /* .. */ }
   

2. 也可以使用 JSON 作为 body data

   use rocket::serde::{Deserialize, json::Json};
   
   #[derive(Deserialize)]
   #[serde(crate = "rocket::serde")]
   struct Task<'r> {
      description: &'r str,
      complete: bool
   }
   
   #[post("/todo", data = "<task>")]
   fn new(task: Json<Task<'_>>) { /* .. */ }
   

JSON

1. 在 Cargo.toml 中添加 json feature.

   rocket = { version = "=0.5.0-rc.3", features = ["json"] }
   

2. 引入 Rocket 中的 json crate

   use rocket::serde::json::serde_json::json;
   use rocket::serde::json::{Json, Value};
   use rocket::serde::{Deserialize, Serialize};
   

3. 创建结构体，并序列化

   #[derive(Serialize, Deserialize)]
   #[serde(crate = "rocket::serde")]
   struct Person<'a> {
      id: usize,
      name: &'a str,
      age: u8,
   }
   
   

4. 通过 Json 结构体 或 json!, 创建 Json

   #[get("/")]
   fn index<'a>() -> Json<Person<'a>> {
      Json(Person {
         id: 0,
         name: "Tome",
         age: 9,
      })
   }
   
   #[get("/ex/<id>")]
   async fn get_ex(id: usize) -> Value {
      json!(Person { id, name: "Joy", age: 10 })
   }
   

5. 完整代码参考: github.com/panmin-code…

参考

• # Rust Rocket web 框架学习 一 Hello world