快速開始

安裝 Rust

如果你還沒有安裝 Rust, 你可以使用官方提供的 rustup 安裝 Rust. 官方教程在新窗口打開中有如何安裝的詳細介紹.

當前 Salvo 支持的最低 Rust 版本為 1.64. 運行 rustup update 確認您已經安裝了符合要求的 Rust.

編寫第一個 Salvo 程序

創建一個全新的項目:

cargo new hello_salvo --bin

添加依賴項到 Cargo.toml

[dependencies]
salvo = "*"
tokio = { version = "1", features = ["macros"] }

在 main.rs 中創建一個簡單的函數句柄, 命名為hello_world, 這個函數只是簡單地打印文本 "Hello world".

use salvo::prelude::*;

#[handler]
async fn hello_world() -> &'static str {
    "Hello world"
}
#[tokio::main]
async fn main() {
    let router = Router::new().get(hello_world);
    Server::new(TcpListener::bind("127.0.0.1:7878")).serve(router).await;
}

恭喜你, 你的一個 Salvo 程序已經完成. 只需要在命令行下運行 cargo run, 然後在瀏覽器裏打開 http://127.0.0.1:7878 即可.

詳細解讀

這裏的 hello_world 是一個 Handler, 用於處理用戶請求. #[handler] 可以讓一個函數方便實現 Handler trait. 並且, 它允許我們用不同的方式簡寫函數的參數.

原始形式:

#[handler]
async fn hello_world(_req: &mut Request, _depot: &mut Depot, res: &mut Response, _ctrl: &mut FlowCtrl) {
    res.render("Hello world");
}

您可以省略函數中某些用不著的參數, 比如這裏面的 _req, _depot, _ctrl 都沒有被使用, 可以直接不寫:
```
#[handler]
async fn hello_world(res: &mut Response) {
    res.render("Hello world");
}
```
任何類型都可以作為函數的返回類型, 只要它實現了 Writer trait. 比如 &str 實現了 Writer, 當它被作為返回值時, 就打印純文本:
```
#[handler]
async fn hello_world(res: &mut Response) -> &'static str {
    "Hello world"
}
```
更普遍的情況是, 我們需要在將 Result<T, E> 作為返回類型, 以便處理函數執行過程中的錯誤. 如果 T 和 E 都實現了 Writer, 那麽 Result<T, E> 就可以作為返回值:
```
#[handler]
async fn hello_world(res: &mut Response) -> Result<&'static str, ()> {
    Ok("Hello world")
}
```

# 快速開始

# 安裝 Rust

# 編寫第一個 Salvo 程序

# 詳細解讀

# 更多示例

快速開始

安裝 Rust

編寫第一個 Salvo 程序

詳細解讀

更多示例