Rust Web 历程
Rust 的异步框架tokio非他莫属,而web框架一直是悬而未决,说到底还是因为没有官方成熟的方案指引,大家各玩各的,互不兼容,白白浪费精力。
这个事情一直等到半官方组织tokio推出axum有了改善。但是市场上仍然乱七八糟,具体细节可以参考:https://zhuanlan.zhihu.com/p/398232138
现在相对靠谱的发展方向参考如下图:
但是 tower和tower-http这2个项目比较奇葩,sample和docment严重缺少,所以建议做如下研究:
- tokio
- axum
- tonic
- sqlx
axum 简单demo
这个框架也不是特别成熟,在multipart有大坑!
注意仔细参考我的代码!
rust
use axum::{extract::{DefaultBodyLimit, Form, Multipart, Path, Query}, http::{Method, StatusCode}, response::{Html, IntoResponse}, routing::{get, post}, Json, Router};
use serde::{Deserialize, Serialize};
#[tokio::main]
async fn main() {
let routes = Router::new()
.route("/", get(page_index))
.route("/hello", get(|| async {
println!("{:<12} - hello", "HANDLER");
Html("hello world!")
}))
.route("/user", post(page_user))
.route("/user2", get(page_user2))
.route("/user3/:username", get(page_user3))
.route("/form", get(form_get).post(form_post))
// 复杂的提取,需要参考 https://docs.rs/axum/latest/axum/extract/index.html
.route("/form2", get(form_get_file).post(form_post_file).layer(DefaultBodyLimit::disable()))
;
let listener = tokio::net::TcpListener::bind("0.0.0.0:8080").await.unwrap();
println!("Server listen on: {:?}", listener.local_addr());
axum::serve(listener, routes).await.unwrap();
}
#[derive(Deserialize, Debug)]
struct ReqUser {
username: String,
}
#[derive(Serialize, Debug,Deserialize)]
struct RespUser {
id: u64,
username: String,
}
async fn page_index() -> &'static str{
"welcome to axum based on tokio!"
}
// e.g.: Post /user Body: {"username": "xxxx"}
async fn page_user(
Json(req): Json<ReqUser>,
) -> (StatusCode, Json<RespUser>) {
println!("{:<12} - page_user - {req:?}", "HANDLER");
let user = RespUser {
id: 1337,
username: req.username,
};
(StatusCode::OK, Json(user))
}
// e.g.: GET /user2?username=abc
async fn page_user2(
Query(req) : Query<ReqUser>
) -> impl IntoResponse {
println!("{:<12} - page_user2 - {req:?}", "HANDLER");
let user = RespUser {
id: 1338,
username: req.username,
};
Html(format!("{user:?}"))
}
// e.g.: GET /user3/username
async fn page_user3(
Path(req_name) : Path<String>
) -> impl IntoResponse {
println!("{:<12} - page_user3 - {req_name:?}", "HANDLER");
let user = RespUser {
id: 1339,
username: req_name,
};
Html(format!("{user:?}"))
}
async fn form_get() -> Html<&'static str> {
Html(
r#"
<!doctype html>
<html>
<head>form test</head>
<body>
<h2> normal form </h2>
<form action="/form" method="post">
<label for="username">
Enter your name:
<input type="text" name="username">
</label><br>
<label>
Enter your id:
<input type="text" name="id">
</label><br>
<input type="submit" value="Ok">
</form>
</body>
</html>
"#,
)
}
async fn form_get_file() -> Html<&'static str> {
Html(
r#"
<!doctype html>
<html>
<head>form test</head>
<body>
<h2> normal form </h2>
<form action="/form2" method="post" enctype="multipart/form-data">
<label>
Enter your id:
<input type="text" name="id">
</label><br>
<label>
Upload file:
<input type="file" name="myfile" multiple>
</label><br>
<input type="submit" value="Upload files">
</form>
</body>
</html>
"#,
)
}
// 支持多个提取器
async fn form_post(
_method: Method,
Form(user): Form<RespUser>
) -> String {
//dbg!(&user);
format!("{user:?}")
}
// body 部分只支持一种,不冲突的支持多种
// Form与Multipart冲突,保留multipart
async fn form_post_file(
_method: Method,
mut multipart: Multipart,
) -> String {
while let Some(field) = multipart.next_field().await.unwrap() {
let name = field.name().unwrap().to_string();
if name == "myfile" {
let file_name = field.file_name().unwrap().to_string();
let content_type = field.content_type().unwrap().to_string();
let data = field.bytes().await.unwrap();
println!("form upload [{name}] = {file_name}, data len: {}, type: {content_type}",data.len());
}else{
let val = field.text().await.unwrap();
println!("form field [{name}] = {val}");
}
}
format!("{_method:?}")
}