middleware.inject

Inner request middleware layer before handlers.

When
After request.intercept hooks, before handle_request logging.
Input
Same as request.intercept.
Output
Same as request.intercept.
Route matching
Same prefix rules as request.intercept.

Second request hook phase. Use for cross-cutting checks that should run after outer auth but before route handlers — header normalization, tracing tags, request enrichment.

Pipeline

Runs after intercept hooks on the same route prefix.

Use cases

  • Validate content-type on POST routes
  • Attach request context for downstream hooks
  • Soft limits that allow fallback handlers

Example

Registration and handler

Register

hook_request!(host, RequestHookPhase::Middleware, "/api/*", on_middleware);

Handler

extern "C" fn on_middleware(_ctx: *const RequestHookContext) -> i32 {
    REQUEST_CONTINUE
}

← Back to index