mod opts;
mod reply;
mod resolve;
mod security;
#[cfg(feature = "directory-listing")]
mod listing;
pub use opts::{HandleOpts, StaticFileResponse};
#[doc(hidden)]
pub use crate::fs::path::sanitize_path;
use hyper::StatusCode;
use crate::Result;
use crate::exts::http::MethodExt;
use crate::fs::meta::FileMetadata;
#[cfg(feature = "mem-cache")]
use crate::mem_cache::cache;
#[cfg(feature = "mem-cache")]
use opts::DEFAULT_INDEX_FILES;
pub async fn handle(opts: &HandleOpts<'_>) -> Result<StaticFileResponse, StatusCode> {
if !opts.method.is_allowed() {
return Err(StatusCode::METHOD_NOT_ALLOWED);
}
if opts.method.is_options() {
return Ok(StaticFileResponse {
resp: reply::options_reply(),
file_path: None,
is_dir_listing: false,
});
}
let mut file_path = sanitize_path(opts.base_path, opts.uri_path)?;
#[cfg(feature = "mem-cache")]
if let Some(resp) = try_memory_cache(opts, &file_path) {
return Ok(resp);
}
let FileMetadata {
file_path,
metadata,
is_dir,
precompressed_variant,
file,
} = resolve::file_metadata(
&mut file_path,
opts.headers,
opts.compression_static,
opts.index_files,
)?;
let is_dir_listing = is_dir && metadata.is_dir();
security::enforce(file_path, is_dir_listing, opts)?;
if let Some((precomp_path, _)) = &precompressed_variant {
security::enforce(precomp_path, false, opts)?;
}
let resp_file_path = file_path.to_owned();
if let Some(resp) = reply::trailing_slash_redirect(is_dir, opts)? {
return Ok(StaticFileResponse::new(resp, resp_file_path));
}
#[cfg(feature = "directory-listing")]
if let Some(resp) = listing::try_listing(file_path, is_dir, opts)? {
return Ok(StaticFileResponse {
is_dir_listing: true,
..StaticFileResponse::new(resp, resp_file_path)
});
}
let resp =
reply::file_or_precompressed(opts, file_path, &metadata, precompressed_variant, file)?;
Ok(StaticFileResponse::new(resp, resp_file_path))
}
#[cfg(feature = "mem-cache")]
fn try_memory_cache(
opts: &HandleOpts<'_>,
file_path: &std::path::Path,
) -> Option<StaticFileResponse> {
opts.memory_cache.as_ref()?;
if !opts.method.is_get() && !opts.method.is_head() {
return None;
}
let index_path = (opts.redirect_trailing_slash && opts.uri_path.ends_with('/')).then(|| {
let index = opts.index_files.first().unwrap_or(&DEFAULT_INDEX_FILES[0]);
file_path.join(index)
});
let cache_path = index_path.as_deref().unwrap_or(file_path);
let result = cache::lookup(cache_path, opts.headers, opts.compression_static)?;
match result {
Ok(resp) => {
let resp_file_path = index_path.unwrap_or_else(|| file_path.to_path_buf());
Some(StaticFileResponse::new(resp, resp_file_path))
}
Err(_) => None,
}
}