ファイルの送信

Salvoでは以下の方法でファイルを送信できます:

NamedFile

Salvoはsalvo::fs::NamedFileを提供しており、これを使用してクライアントに効率的にファイルを送信できます。これはファイル全体をキャッシュに読み込むのではなく、リクエストのRangeに基づいて部分的な内容を読み込み、クライアントに送信します。

実際、Response::send_fileはNamedFileを簡略化して使用する方法です。ファイル送信をより細かく制御したい場合は、NamedFileBuilderを使用できます。

NamedFile::builderでNamedFileBuilderを作成できます:

#[handler]
async fn send_file(req: &mut Request, res: &mut Response) {
    let builder = NamedFile::builder("/file/to/path");
}

いくつかの設定を行った後、ファイルを送信できます:

#[handler]
async fn send_file(req: &mut Request, res: &mut Response) {
    NamedFile::builder("/file/to/path").attached_name("image.png").send(req.headers(), res).await;
}

静的ファイルの提供

静的ファイルや埋め込まれたファイルをサービスとして提供するミドルウェアです。

StaticDirはローカルの静的フォルダをサポートしています。複数のフォルダのリストを引数として渡せます。例:

main.rs

Cargo.toml

static-dir-list/src/main.rs

use salvo::prelude::*;
use salvo::serve_static::StaticDir;

#[tokio::main]
async fn main() {
    tracing_subscriber::fmt().init();

    let router = Router::with_path("{*path}").get(
        StaticDir::new([
            "static-dir-list/static/boy",
            "static-dir-list/static/girl",
            "static/boy",
            "static/girl",
        ])
        .include_dot_files(false)
        .defaults("index.html")
        .auto_list(true),
    );

    let acceptor = TcpListener::new("0.0.0.0:5800").bind().await;
    Server::new(acceptor).serve(router).await;
}

最初のフォルダに対応するファイルが見つからない場合、2番目のフォルダを探します。

rust-embedのサポートも提供しています。例:

main.rs

Cargo.toml

static-embed-files/src/main.rs

use rust_embed::RustEmbed;
use salvo::prelude::*;
use salvo::serve_static::static_embed;

#[derive(RustEmbed)]
#[folder = "static"]
struct Assets;

#[tokio::main]
async fn main() {
    tracing_subscriber::fmt().init();

    let router = Router::with_path("{*path}").get(static_embed::<Assets>().fallback("index.html"));

    let acceptor = TcpListener::new("0.0.0.0:5800").bind().await;
    Server::new(acceptor).serve(router).await;
}

with_fallbackを使用すると、ファイルが見つからない場合に代わりに使用するファイルを設定できます。これはシングルページアプリケーションなどで有用です。

このページ内

#ファイルの送信

#NamedFile

#静的ファイルの提供

ファイルの送信

NamedFile

静的ファイルの提供