Struct FacadeMiddleware

pub struct FacadeMiddleware {
    pub configuration: CredenceConfiguration,
}

Axum middleware that handles the URI facade.

• Redirects trailing slashes (301)
• Hides paths (404) that end with .html, .r.*, or other configured suffixes
• Rewrites to .html or .r.* files if they exist
• Otherwise if it’s a directory rewrites to index.html or index.r.* if they exist in it

All of the above is handled by attaching a DeferredResponse to the request (not the response). We do this because request mapping middleware cannot return a normal response. Thus, we also need to install [CatchMiddleware], which “catches” the deferment and generates the actual response.

(Remember that axum runs through layers in the reverse order in which they are programmatically added, so add [CatchMiddleware] first and then add FacadeMiddleware.)

We referred to “normal” responses above, because actually request mapping can return “abnormal” responses: as a Result::Err. We can consider them abnormal because they circumvent the remaining middleware, thus making that codepath unsuitable for us.

Fields

configuration: CredenceConfiguration

Configuration.

Implementations

impl FacadeMiddleware

pub fn new(configuration: CredenceConfiguration) -> Self

Constructor.

pub async fn function(__arg0: State<Self>, request: Request) -> Request

To be used with [map_request_with_state].

Trait Implementations

impl Clone for FacadeMiddleware

fn clone(&self) -> FacadeMiddleware

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FacadeMiddleware

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.