Rocket 框架虽然可以提供静态文件,但有时候我们的数据源并不是文件,而可能是从数据库捞出来的数据,或者是由程序动态产生出来的数据。虽然 Rocket 框架可以直接使用 Vec<u8> 来作为回应的类型,但使用起来并不是很方便,因为在回应二进制数据时,除非是让特定程序访问的 API,不然我们几乎是一定会需要替回应的数据设置内容类型(Content-Type)的,否则网页浏览器就不会知道服务器回应的数据要如何打开,而直接跳出下载窗口。
Raw Response for Rocket Framework
「Raw Response for Rocket Framework」是笔者开发的套件,可以使 Rocket 框架直接回应一个 Vec<u8> 实体、一个 Reader 或是一个文件,并且快速地替其加入 Content-Type 标头。
Crates.io
Cargo.toml
使用方法
rocket_raw_response 这个 crate 提供的 RawResponse 结构体可以当作要回应的数据类型。RawResponse 结构体提供了 from_slice 关联函数和 from_vec 关联函数,可以从参数中传入要拿来回应的 &'static [u8] 参考或 Vec<u8> 实体、文件类型和打开时预设的文件名称(如果不设置文件名称的话,网页浏览器会用网址路径的文件名称来当作文件名称)。它也提供了 from_reader 关联函数,可以从参数中传入任意有实作 Read 特性的实体、文件类型和打开时预设的文件名称。
如果数据源为文件的话,那就更方便了,可以直接使用 RawResponse 结构体提供的 from_file 关联函数,可以从参数中传入文件路径、文件类型和打开时预设的文件名称。如果不提供文件类型的话,预设会由文件路径中的扩展名来判断;如果不提供文件名称的话,预设会由文件路径中的文件名称来判断;如果想要直接使用网址路径的文件名称作为预设的文件名称的话,那就把文件名称设置为空字符串。
举个例子,假设工作目录中有 examples/images/image.jpg 这张 JPEG 图档。若想要让 Rocket 框架提供这个图档,并且让网页浏览器直接浏览这个图档,而不是将其下载到文件系统的话,程序可以这样写:
#[macro_use]
extern crate rocket;
use std::io::ErrorKind;
use std::path::Path;
use rocket::http::Status;
use rocket_raw_response::RawResponse;
#[get("/")]
async fn view() -> Result<RawResponse, Status> {
let path = Path::join(Path::new("examples"), Path::join(Path::new("images"), "image.jpg"));
RawResponse::from_file(path, None::<String>, None).await.map_err(|err| {
if err.kind() == ErrorKind::NotFound {
Status::NotFound
} else {
Status::InternalServerError
}
})
}
#[launch]
fn rocket() -> _ {
rocket::build().mount("/", routes![view])
}
