Struct SchemaLearner 

pub struct SchemaLearner { /* private fields */ }

Thread-safe schema learner for API endpoints.

Uses DashMap for lock-free concurrent access to endpoint schemas. Implements O(1) amortized LRU eviction when max_schemas is exceeded.

Implementations

impl SchemaLearner

pub fn new() -> Self

Create a new schema learner with default configuration.

pub fn with_config(config: SchemaLearnerConfig) -> Self

Create a new schema learner with custom configuration.

pub fn config(&self) -> &SchemaLearnerConfig

Get current configuration.

pub fn len(&self) -> usize

Get number of tracked schemas.

pub fn is_empty(&self) -> bool

Check if empty.

pub fn learn_from_request(&self, template: &str, request_body: &Value)

Learn schema from a request body.

Updates the endpoint schema with field types and constraints learned from the JSON body.

Note

Only JSON object bodies are processed. Array-root bodies (e.g., [{...}]) are silently skipped. This is a known limitation for APIs that use arrays as the root element in request/response bodies.

pub fn learn_from_response(&self, template: &str, response_body: &Value)

Learn schema from a response body.

Note

Only JSON object bodies are processed. Array-root bodies (e.g., [{...}]) are silently skipped. This is a known limitation for APIs that use arrays as the root element in request/response bodies.

pub fn learn_from_pair( &self, template: &str, request_body: Option<&Value>, response_body: Option<&Value>, )

Learn from both request and response.

Note

Only JSON object bodies are processed. Array-root bodies (e.g., [{...}]) are silently skipped. This is a known limitation for APIs that use arrays as the root element in request/response bodies.

pub fn validate_request( &self, template: &str, request_body: &Value, ) -> ValidationResult

Validate a request body against the learned schema.

Returns a list of violations. Empty list means validation passed. Returns empty if schema doesn’t exist or has insufficient samples.

pub fn validate_response( &self, template: &str, response_body: &Value, ) -> ValidationResult

Validate a response body against the learned schema.

pub fn get_schema(&self, template: &str) -> Option<EndpointSchema>

Get schema for an endpoint.

pub fn get_all_schemas(&self) -> Vec<EndpointSchema>

Get all schemas.

pub fn get_stats(&self) -> SchemaLearnerStats

Get statistics.

pub fn export(&self) -> Vec<EndpointSchema>

Export all schemas for persistence.

pub fn import(&self, schemas: Vec<EndpointSchema>)

Import schemas from persistence.

pub fn clear(&self)

Clear all schemas.

Trait Implementations

impl Default for SchemaLearner

fn default() -> Self

Returns the “default value” for a type.