Struct valor_core::Handler

pub struct Handler<L> { /* fields omitted */ }

The main entry point for dispatching incoming requests to plugins registered under a specific URL prefix.

let handler = Handler::new(())
    .with_plugin("foo", |req: Request| async move { req.url().path().into() });

let mut request = Request::new(Method::Get, "http://example.com/_foo/bar/baz");
request.insert_header("x-request-id", "123");
let mut res = handler.handle_request(request).await.unwrap();

assert_eq!(res.status(), StatusCode::Ok);
assert_eq!(res.header("x-correlation-id").unwrap(), "123");
assert_eq!(res.header("x-valor-plugin").unwrap(), "foo");
assert_eq!(res.body_string().await.unwrap(), "/bar/baz");

Implementations

impl<L: Loader + 'static> Handler<L>

pub fn new(loader: L) -> Self

Creates a new Handler instance

pub async fn load_plugin(&self, plugin: Plugin) -> Result<(), LoadError>

Uses the configured loader to load and register the provided plugin

pub fn with_health(self) -> Self

Include the built-in health plugin that returns Ok on _health

pub fn with_plugin<H>(self, plugin: impl Into<Plugin>, handler: H) -> Self where
    H: RequestHandler + 'static, 

Adds a plugin with its handler to the internal registry

pub async fn handle_request(
    &self,
    request: impl Into<Request>
) -> Result<Response, Response>

Handles an incoming request by answering form a plugin that matches the URL pattern

It requires the request to specify a x-request-id header that is set back on the response as x-correlation-id(e.g. used by valor_web to match requests and responses)

Trait Implementations

impl<L> Clone for Handler<L>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.