Отправка файлов
Salvo предоставляет несколько способов отправки файлов:
NamedFile
Salvo предлагает salvo::fs::NamedFile для эффективной отправки файлов клиенту. Вместо загрузки всего файла в память, он загружает только запрошенные части согласно заголовку Range.
Фактически, Response::send_file — это упрощённый способ использования NamedFile. Если требуется больше контроля над отправляемым файлом, можно использовать NamedFileBuilder.
Создать NamedFileBuilder можно через NamedFile::builder:
#[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 поддерживает статические локальные папки. Можно указать список из нескольких папок. Например:
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;
}
Если файл не найден в первой папке, поиск продолжится во второй.
- Поддержка
rust-embed. Например:
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 позволяет указать файл для отображения при отсутствии запрошенного, что полезно для одностраничных приложений.
