Struct RouteCtx 

pub struct RouteCtx { /* private fields */ }

What a contributed route is given at boot.

Deliberately narrow: the admin’s own router state stays private, so its composition can change without breaking a screen. Fields are read through accessors, so this can gain context after 1.0; new cannot, and extra context would arrive as a builder.

Implementations

impl RouteCtx

pub async fn audit( &self, user: &AuthenticatedUser, action: &str, target_type: Option<&str>, target_id: Option<&str>, target_label: Option<&str>, detail: Option<&str>, )

Appends one audit entry for a mutation user just performed through a module’s own screen. A failed write is logged and never fails the operation it records.

pub fn value_form( &self, fields: &[FormField], scope: &str, ) -> Result<ValueForm, Text>

A form over a JSON object from fields, rendered and collected through the registered field types; scope names what an override is scoped to. Refused, naming the field, when a type is unregistered or an option malformed: the fields may come from data edited at runtime.

pub fn db(&self) -> &Db

pub fn form(&self, path: &str) -> Option<FormHandle>

A resource’s form, to write its records from code: an importer, a sync, anything that saves what an operator could have typed.

path is the resource’s path as its descriptor declares it, relative to the admin root (/products). None when no resource mounts there or the one that does has no form. The handle is Clone and owns what it needs, so a detached task may keep it.

pub fn events(&self) -> &Events

The application’s event bus, for a route that announces a fact: ctx.events().emit(&Published { article_id }).await. Clone it into the route’s state.

pub fn base_url(&self) -> &str

The site’s own origin, without a trailing slash: the configured app.url, falling back to the bind address when none is declared.

For the absolute URLs a route has to emit rather than link: a <loc> in a sitemap, a canonical URL, an entry in a feed. The request’s Host header is not a substitute, because behind a proxy it is whatever the proxy sent.

pub fn contributions<T: Send + Sync + 'static>(&self) -> Vec<&T>

The contributions of type T that the framework itself does not consume.

This is how one module reads another’s contributions. A module declaring its own kind of extension point defines a type, other modules contribute it from their register, and the route reads them here: the framework never learns the type, and registration order does not matter because everything is collected before any route runs.

pub fn base_path(&self) -> &str

Where this screen actually mounted, after the module namespace, any base it declared, the deployment’s overrides and the admin mount.

pub fn admin_path(&self) -> &str

Where the admin panel is mounted, after backend.path. Ask rather than assuming /admin: an operator may have moved it, and a module building a link into the panel, or excluding it from a sitemap, needs the real one.

pub fn url(&self, relative: &str) -> String

An absolute admin URL under this screen. Build every self-link this way: a deployment can move the screen, so a hardcoded path would break.

pub fn builder(db: Db) -> RouteCtxBuilder

A context built by hand, for testing a route without booting the framework.

mount takes a RouteCtx, and the framework’s own constructor is private, so without this a plugin could only exercise its routes through a full boot. With it, a route is an ordinary tower service:

let ctx = RouteCtx::builder(db).admin_path("/backoffice").build();
let response = MyRoute.mount(&ctx).oneshot(request).await?;

This is also how the context grows after 1.0: a new field gets a builder method and a default, which new could not have offered.

Trait Implementations

impl Clone for RouteCtx

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.