用途:面向 Rust 的 Axum v0.8.x 后端开发指南,帮助组织 Web 服务的处理器、路由、中间件、认证与错误处理等实现。
主要能力:资料覆盖处理器(使用 Path、Query、State、Json 等提取器与 IntoResponse 返回)、路由(get/post/put/delete、nest、layer、with_state)、错误处理(自定义 AppError 并实现 IntoResponse 与 Fromsqlx::Error)、中间件(middleware::from_fn 与日志示例)、自定义提取器(实现 FromRequestParts 解析 Claims)、认证中间件、CORS(tower_http::cors::CorsLayer)、响应头与 Cookie(Set-Cookie 与 HttpOnly/Secure/SameSite)、文件上传(Multipart 逐字段读取)。
使用方式:按需参考对应片段编写代码,例如用 State 注入连接池、用 Path 获取路径参数、用 Json 解析请求体;路由上通过 .route 与 .nest 组合,并用 .layer 添加中间件与 CORS,最后 with_state 绑定状态。错误处理可定义统一 AppError,并将其作为提取器与处理器的错误类型。
注意事项(来自资料 Notes):提取器顺序应将 State 放在最后,因为其他提取器可能消耗请求体;全应用使用一致的单一 AppError;中间件执行顺序为外到内,与 layer 添加顺序相反;State 类型必须实现 Clone,通常用 Arc 包裹。
限制:资料未提供安装命令、依赖版本细节、运行示例、性能数据、收费信息或适用平台范围,相关内容暂未提供。