Rust 实战练习 - 12. Axum Web 简单demo

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:?}")
}
相关推荐
一点媛艺1 分钟前
Kotlin函数由易到难
开发语言·python·kotlin
姑苏风6 分钟前
《Kotlin实战》-附录
android·开发语言·kotlin
耶啵奶膘34 分钟前
uniapp-是否删除
linux·前端·uni-app
奋斗的小花生1 小时前
c++ 多态性
开发语言·c++
魔道不误砍柴功1 小时前
Java 中如何巧妙应用 Function 让方法复用性更强
java·开发语言·python
闲晨1 小时前
C++ 继承:代码传承的魔法棒,开启奇幻编程之旅
java·c语言·开发语言·c++·经验分享
老猿讲编程2 小时前
一个例子来说明Ada语言的实时性支持
开发语言·ada
王哈哈^_^2 小时前
【数据集】【YOLO】【目标检测】交通事故识别数据集 8939 张,YOLO道路事故目标检测实战训练教程!
前端·人工智能·深度学习·yolo·目标检测·计算机视觉·pyqt
Chrikk3 小时前
Go-性能调优实战案例
开发语言·后端·golang
幼儿园老大*3 小时前
Go的环境搭建以及GoLand安装教程
开发语言·经验分享·后端·golang·go