Struct UnifiedRouter 

pub struct UnifiedRouter { /* private fields */ }

Available on crate feature client-router only.

Unified router combining server and client routing capabilities.

This struct provides a unified interface for configuring both:

• Server-side routes: HTTP methods, middleware, DI, ViewSets
• Client-side routes: SPA navigation, history API, Page rendering

Example

use reinhardt_urls::routers::UnifiedRouter;
use reinhardt_core::page::Page;

let router = UnifiedRouter::new()
    .server(|s| s.function("/api/health", Method::GET, health_handler))
    .client(|c| c.route("/", || home_page()));

Implementations

impl UnifiedRouter

pub fn new() -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Creates a new UnifiedRouter with default server and client routers.

pub fn server<F>(self, f: F) -> UnifiedRouter

where F: FnOnce(ServerRouter) -> ServerRouter,

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Configure server-side routing with a closure.

The closure receives a ServerRouter and should return a configured router.

Example

let router = UnifiedRouter::new()
    .server(|s| s
        .with_prefix("/api")
        .function("/users", Method::GET, list_users));

pub fn client<F>(self, f: F) -> UnifiedRouter

where F: FnOnce(ClientRouter) -> ClientRouter,

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Configure client-side routing with a closure.

The closure receives a ClientRouter and should return a configured router.

Example

let router = UnifiedRouter::new()
    .client(|c| c
        .route("/", || home_page())
        .route_path("/users/{id}", |Path(id): Path<i64>| user_page(id)));

pub fn server_ref(&self) -> &ServerRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Returns a reference to the server router.

pub fn server_mut(&mut self) -> &mut ServerRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Returns a mutable reference to the server router.

pub fn client_ref(&self) -> &ClientRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Returns a reference to the client router.

pub fn client_mut(&mut self) -> &mut ClientRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Returns a mutable reference to the client router.

pub fn into_server(self) -> ServerRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Consumes the router and returns the server router.

If this router has a DI context, deferred DI registrations are applied directly to its singleton scope. Otherwise they are stashed in the global registry for later application by the server.

pub fn into_client(self) -> ClientRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Consumes the router and returns the client router.

pub fn into_parts(self) -> (ServerRouter, ClientRouter)

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Consumes the router and returns both parts.

pub fn register_globally(self) -> ClientRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Registers server router globally and returns client router.

This is a convenience method for full-stack applications that need to:

1. Register the server router globally for HTTP request handling
2. Keep the client router for SPA navigation

Example

let client = UnifiedRouter::new()
    .server(|s| s.function("/api/data", Method::GET, handler))
    .client(|c| c.route("/", || home_page()))
    .register_globally();

// Server router is now globally registered
// Client router is returned for SPA use

pub fn with_di_registrations(self, list: DiRegistrationList) -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Attach deferred DI registrations to this router.

When the router is consumed, these registrations are applied directly to the DI context’s singleton scope if one has been set via with_di_context. Otherwise they are stashed globally for later application (e.g., by the runall command).

pub fn with_prefix(self, prefix: impl Into<String>) -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Set URL prefix for server router.

This is a convenience method that delegates to ServerRouter::with_prefix.

pub fn with_namespace(self, namespace: impl Into<String>) -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Set namespace for server router.

This is a convenience method that delegates to ServerRouter::with_namespace.

pub fn with_di_context(self, ctx: Arc<InjectionContext>) -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Set DI context for server router.

This is a convenience method that delegates to ServerRouter::with_di_context.

pub fn with_middleware<M>(self, middleware: M) -> UnifiedRouter

where M: Middleware + 'static,

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Add middleware to server router.

This is a convenience method that delegates to ServerRouter::with_middleware.

pub fn exclude(self, pattern: &str) -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Exclude a URL path from the most recently added server middleware.

This is a convenience method that delegates to ServerRouter::exclude.

pub fn mount(self, prefix: &str, child: ServerRouter) -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Mount a child server router on this router.

This is a convenience method that delegates to ServerRouter::mount.

pub fn mount_unified(self, prefix: &str, child: UnifiedRouter) -> UnifiedRouter

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Mount a child UnifiedRouter on this router.

Extracts the server router from the child and mounts it.

pub fn endpoint<F, E>(self, f: F) -> UnifiedRouter

where F: FnOnce() -> E, E: EndpointInfo + Handler + 'static,

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Register an endpoint on server router.

This is a convenience method that delegates to ServerRouter::endpoint.

pub fn function<F, Fut>( self, path: &str, method: Method, func: F, ) -> UnifiedRouter

where F: Fn(Request) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Response, Error>> + Send + 'static,

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Register a function-based route on server router.

This is a convenience method that delegates to ServerRouter::function.

pub fn function_named<F, Fut>( self, path: &str, method: Method, name: &str, func: F, ) -> UnifiedRouter

where F: Fn(Request) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Response, Error>> + Send + 'static,

Available on crate feature test and non-WebAssembly and (non-WebAssembly or crate feature client-router) only.

Register a named function-based route on server router.

This is a convenience method that delegates to ServerRouter::function_named.

Trait Implementations

impl DeeplinkRouterExt for UnifiedRouter

type Output = UnifiedRouter

The output type after adding deeplinks.

fn with_deeplinks( self, config: DeeplinkConfig, ) -> Result<UnifiedRouter, DeeplinkError>

Adds deeplink handlers to the router.

impl Default for UnifiedRouter

Available on non-WebAssembly only.

fn default() -> UnifiedRouter

Returns the “default value” for a type.