Struct MiddlewareScope 

pub struct MiddlewareScope { /* private fields */ }

Selects the requests one registered middleware layer observes.

An empty scope matches every request, which is what HttpApp::with_middleware registers. Path prefixes and operation predicates combine as AND between the two categories and OR inside one category.

The selected operation is unknown before routing, so a scope that declares an operation predicate never matches HttpMiddleware::on_request; that layer sees HttpMiddleware::on_operation and HttpMiddleware::on_response instead. A layer whose scope does not match is also not counted by the security guard, so a scoped verifier cannot silently authorize an operation outside its subtree.

Implementations

impl MiddlewareScope

pub const fn all() -> Self

A scope that constrains nothing.

pub fn prefix(prefix: &str) -> Self

A scope limited to one path prefix.

pub fn operation(operation_id: &str) -> Self

A scope limited to one operation id.

pub fn with_prefix(self, prefix: &str) -> Self

Adds an accepted path prefix, matched on segment boundaries.

/ingest matches /ingest and /ingest/events, never /ingested.

pub fn with_operation(self, operation_id: &str) -> Self

Adds one accepted operation id.

pub fn with_operation_prefix(self, prefix: &str) -> Self

Adds an accepted operation id prefix, for id namespaces such as ingest..

pub fn with_operation_filter<Filter>(self, filter: Filter) -> Self

where Filter: Fn(&str) -> bool + 'static,

Adds an operation id predicate for a selection the other constraints cannot express.

pub fn is_global(&self) -> bool

Returns whether this scope constrains nothing.

pub fn matches_request(&self, path: &str) -> bool

Matches before routing, when only the request path is known.

pub fn matches_operation(&self, path: &str, operation_id: &str) -> bool

Matches after routing, when the selected operation is known.

Trait Implementations

impl Clone for MiddlewareScope

fn clone(&self) -> MiddlewareScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MiddlewareScope

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

Formats the value using the given formatter.

impl Default for MiddlewareScope

fn default() -> MiddlewareScope

Returns the “default value” for a type.