[/badge.svg?branch=master&event=push)](https://github.com/salvo-rs/salvo/actions)
[/badge.svg?branch=master&event=push)](https://github.com/salvo-rs/salvo/actions)
[/badge.svg?branch=master&event=push)](https://github.com/salvo-rs/salvo/actions)
[](https://codecov.io/gh/salvo-rs/salvo)
[](https://crates.io/crates/salvo)
[](https://crates.io/crates/salvo)
Salvo 是一个简单易用的 Rust Web 后端框架.
🎯 功能
- 基于最新版本的 hyper, tokio;
- 支持 Websocket;
- 支持从多个本地目录映射成一个虚拟目录提供服务;
- 中间件系统支持在句柄之前或者之后运行;
- 简单易用的路由系统:
⚡️ 快速开始
你可以从这里查看实例代码， 或者从这里查看文档。
创建一个全新的项目:
bash
cargo new hello_salvo --bin
添加依赖项到 Cargo.toml
toml
[dependencies]
salvo = "0.4"
tokio = { version = "1.1", features = ["full"] }
在 main.rs 中创建一个简单的函数句柄, 命名为hello_world, 这个函数只是简单地打印文本 "Hello World".
```rust
use salvo::prelude::*;
[fn_handler]
async fn helloworld(req: &mut Request, depot: &mut Depot, res: &mut Response) {
res.renderplain_text("Hello World");
}
```
在 main 函数中, 我们需要首先创建一个根路由, 然后创建一个 Server 并且调用它的 bind 函数:
```rust
use salvo::prelude::*;
[fn_handler]
async fn helloworld(res: &mut Response) {
res.renderplain_text("Hello World");
}
[tokio::main]
async fn main() {
let router = Router::new().get(hello_world);
let server = Server::new(router);
server.bind(([0, 0, 0, 0], 7878)).await;
}
```
树状路由系统
```rust
use salvo::prelude::*;
[tokio::main]
async fn main() {
let router = Router::new()
.get(index)
.push(
Router::new()
.path("users")
.before(auth)
.post(createuser)
.push(Router::new().path(r"").post(updateuser).delete(deleteuser)),
)
.push(
Router::new()
.path("users")
.get(listusers)
.push(Router::new().path(r"").get(show_user)),
);
Server::new(router).bind(([0, 0, 0, 0], 7878)).await;
}
[fn_handler]
async fn index(res: &mut Response) {
res.renderplaintext("Hello world!");
}
[fn_handler]
async fn auth(res: &mut Response) {
res.renderplaintext("user has authed\n\n");
}
[fn_handler]
async fn listusers(res: &mut Response) {
res.renderplain_text("list users");
}
[fn_handler]
async fn showuser(res: &mut Response) {
res.renderplain_text("show user");
}
[fn_handler]
async fn createuser(res: &mut Response) {
res.renderplain_text("user created");
}
[fn_handler]
async fn updateuser(res: &mut Response) {
res.renderplain_text("user updated");
}
[fn_handler]
async fn deleteuser(res: &mut Response) {
res.renderplain_text("user deleted");
}
```
☕ 支持者
Salvo是一个开源项目，如果想支持本项目, 可以 ☕ 在这里买一杯咖啡.
⚠️ 开源协议
Salvo 项目采用 MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)