Axum 是由 Tokio 官方团队开发的一个高性能、设计优雅的现代化 Web 框架。
快速使用
假设已经安装了 Rust 开发环境
1 | // main.rs |
1 | $ curl -X GET 'http://127.0.0.1:8000' |
进阶使用
登录场景的需求,如下实现
1 | // main.rs |
1 | $ curl -X POST 'http://127.0.0.1:8000/auth/login' -H 'Content-Type: application/json' -d '{"user":"mark","password":"123456"}' |
JWT
Web 项目一般会采用 JSON Web Token(JWT)来做鉴权,进行如下修改:
1 | // jwt.rs |
1 | // main.rs |
1 | $ curl -X POST 'http://127.0.0.1:8000/auth/login' -H 'Content-Type: application/json' -d '{"user":"mark","password":"123456"}' |
IntoResponse
有时需要对响应包体结构进行修改,可以这样实现:
1 | // response.rs |
1 | // main.rs |
1 | $ curl -X POST "http://127.0.0.1:8000/auth/login" -H 'Content-Type: application/json' -d '{"user":"mark","password":"123456"}' |
Extensions
生成了 JWT Token 之后如何实现鉴权呢?
1 | // jwt_auth.rs |
1 | // main.rs |
1 | $ curl -X GET "http://127.0.0.1:8000/auth/me" |
Extractor
如果希望处理请求时直接获取登录用户,可以先在鉴权中间件中将用户信息写入请求的 extensions,再通过自定义 Extractor 取出:
1 | // model.rs |
1 | // extract.rs |
1 | // jwt_auth.rs |
1 | // main.rs |
1 | $ curl -X GET "http://127.0.0.1:8000/auth/me" -H 'authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtYXJrIiwiaWF0IjoxNzc4NjQ2Njg4LCJleHAiOjE3ODEyMzg2ODgsImlzcyI6Imp3dF9pc3N1ZXIifQ.vzj_ExYeqBL9rrjqGiMWn0ywbp38PrrBy8H2q1Z40oQ' |
最后
这是 Axum 简单使用的示例,涉及的 Service、Layer、Extractor 等核心概念,后续会展开深入学习。