Struct OpenApiRouteRegistry 

pub struct OpenApiRouteRegistry { /* private fields */ }

OpenAPI route registry that manages generated routes

Implementations

impl OpenApiRouteRegistry

pub fn new(spec: OpenApiSpec) -> Self

Create a new registry from an OpenAPI spec

pub fn new_with_env(spec: OpenApiSpec) -> Self

Create a new registry from an OpenAPI spec with environment-based validation options

Options are read from environment variables:

• MOCKFORGE_REQUEST_VALIDATION: “off”/“warn”/“enforce” (default: “enforce”)
• MOCKFORGE_AGGREGATE_ERRORS: “1”/“true” to aggregate errors (default: true)
• MOCKFORGE_RESPONSE_VALIDATION: “1”/“true” to validate responses (default: false)
• MOCKFORGE_RESPONSE_TEMPLATE_EXPAND: “1”/“true” to expand templates (default: false)
• MOCKFORGE_VALIDATION_STATUS: HTTP status code for validation failures (optional)

pub fn new_with_options(spec: OpenApiSpec, options: ValidationOptions) -> Self

Construct with explicit options

pub fn clone_for_validation(&self) -> Self

Clone this registry for validation purposes (creates an independent copy)

This is useful when you need a separate registry instance for validation that won’t interfere with the main registry’s state.

pub fn routes(&self) -> &[OpenApiRoute]

Get all routes

pub fn spec(&self) -> &OpenApiSpec

Get the OpenAPI specification

pub fn build_router(self) -> Router

Build an Axum router from the OpenAPI spec (simplified)

pub fn build_router_with_latency( self, latency_injector: LatencyInjector, ) -> Router

Build an Axum router from the OpenAPI spec with latency injection support

pub fn build_router_with_injectors( self, latency_injector: LatencyInjector, failure_injector: Option<FailureInjector>, ) -> Router

Build an Axum router from the OpenAPI spec with both latency and failure injection support

pub fn build_router_with_injectors_and_overrides( self, latency_injector: LatencyInjector, failure_injector: Option<FailureInjector>, overrides: Option<Overrides>, overrides_enabled: bool, ) -> Router

Build an Axum router from the OpenAPI spec with latency, failure injection, and overrides support

pub fn get_route(&self, path: &str, method: &str) -> Option<&OpenApiRoute>

Get route by path and method

pub fn get_routes_for_path(&self, path: &str) -> Vec<&OpenApiRoute>

Get all routes for a specific path

pub fn validate_request( &self, path: &str, method: &str, body: Option<&Value>, ) -> Result<()>

Validate request against OpenAPI spec (legacy body-only)

pub fn validate_request_with( &self, path: &str, method: &str, path_params: &Map<String, Value>, query_params: &Map<String, Value>, body: Option<&Value>, ) -> Result<()>

Validate request against OpenAPI spec with path/query params

pub fn validate_request_with_all( &self, path: &str, method: &str, path_params: &Map<String, Value>, query_params: &Map<String, Value>, header_params: &Map<String, Value>, cookie_params: &Map<String, Value>, body: Option<&Value>, ) -> Result<()>

Validate request against OpenAPI spec with path/query/header/cookie params

pub fn paths(&self) -> Vec<String>

Get all paths defined in the spec

pub fn methods(&self) -> Vec<String>

Get all HTTP methods supported

pub fn get_operation( &self, path: &str, method: &str, ) -> Option<OpenApiOperation>

Get operation details for a route

pub fn extract_path_parameters( &self, path: &str, method: &str, ) -> HashMap<String, String>

Extract path parameters from a request path by matching against known routes

pub fn convert_path_to_axum(openapi_path: &str) -> String

Convert OpenAPI path to Axum-compatible path This is a utility function for converting path parameters from {param} to :param format

pub fn build_router_with_ai( &self, ai_generator: Option<Arc<dyn AiGenerator + Send + Sync>>, ) -> Router

Build router with AI generator support

Trait Implementations

impl Clone for OpenApiRouteRegistry

fn clone(&self) -> OpenApiRouteRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpenApiRouteRegistry

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

Formats the value using the given formatter.