Struct RouteTable 

pub struct RouteTable { /* private fields */ }

The set of routes registered on an application.

Implementations

impl RouteTable

pub fn new() -> Self

An empty table.

pub fn register(&mut self, method: &str, pattern: &str, meta: RouteMeta)

Register a method on a path.

Registering the same method twice replaces its metadata, which is how a route is redefined.

pub fn remove(&mut self, method: &str, pattern: &str)

Remove a method from a path, dropping the path when it keeps none.

Used by crate::app::LinoApp::without_description to withdraw the description routes the constructor registers.

pub fn find(&self, pathname: &str) -> Option<&RouteEntry>

Find the route entry owning a concrete path.

pub fn match_path(&self, pathname: &str) -> Option<(&RouteEntry, PathParams)>

Find the route entry owning a path together with its path parameters.

Routes are tried in registration order, so an earlier registration wins.

pub fn allowed_methods(&self, pathname: &str) -> Option<Vec<String>>

List the methods allowed on a concrete path.

OPTIONS is always allowed, and HEAD is allowed wherever GET is. The answer is None when no route owns the path.

pub fn allowed_methods_of(&self, entry: &RouteEntry) -> Vec<String>

The methods allowed on a route entry, sorted.

pub fn entries(&self) -> &[RouteEntry]

The registered routes, in registration order.

pub fn describe(&self) -> Vec<RouteDescription>

Render the registry as the routes member of a service description.

Routes are ordered by path, so two servers describing the same routes describe them identically.

Trait Implementations

impl Clone for RouteTable

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RouteTable

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

Formats the value using the given formatter.

impl Default for RouteTable

fn default() -> Self

Returns the “default value” for a type.