Struct actix_web::fs::StaticFiles

pub struct StaticFiles<S> { /* fields omitted */ }

Static files handling

StaticFile handler must be registered with App::handler() method, because StaticFile handler requires access sub-path information.

use actix_web::{fs, App};

fn main() {
    let app = App::new()
        .handler("/static", fs::StaticFiles::new("."))
        .finish();
}

Methods

impl<S: 'static> StaticFiles<S>

pub fn new<T: Into<PathBuf>>(dir: T) -> StaticFiles<S>

Create new StaticFiles instance for specified base directory.

StaticFile uses CpuPool for blocking filesystem operations. By default pool with 20 threads is used. Pool size can be changed by setting ACTIX_FS_POOL environment variable.

pub fn with_pool<T: Into<PathBuf>>(dir: T, pool: CpuPool) -> StaticFiles<S>

Create new StaticFiles instance for specified base directory and CpuPool.

pub fn show_files_listing(self) -> Self

Show files listing for directories.

By default show files listing is disabled.

pub fn index_file<T: Into<String>>(self, index: T) -> StaticFiles<S>

Set index file

Redirects to specific index file for directory "/" instead of showing files listing.

pub fn default_handler<H: Handler<S>>(self, handler: H) -> StaticFiles<S>

Sets default handler which is used when no matched file could be found.

Trait Implementations

impl<S: 'static> Handler<S> for StaticFiles<S>

type Result = Result<Reply, Error>

The type of value that handler will return.

fn handle(&mut self, req: HttpRequest<S>) -> Self::Result

Handle request