Struct RequestValidator 

pub struct RequestValidator { /* private fields */ }

AST-based GraphQL request validator.

Uses graphql-parser to walk the full document tree. Correctly handles operation names, arguments, fragment spreads, inline fragments, and aliases — none of which a character-scan can distinguish from field names.

Implementations

impl RequestValidator

pub fn new() -> RequestValidator

Create a new validator with default settings.

pub const fn from_config(config: &ComplexityConfig) -> RequestValidator

Create from a ComplexityConfig.

pub const fn with_max_depth(self, max_depth: usize) -> RequestValidator

Set maximum query depth.

pub const fn with_max_complexity( self, max_complexity: usize, ) -> RequestValidator

Set maximum query complexity.

pub const fn with_depth_validation(self, enabled: bool) -> RequestValidator

Enable/disable depth validation.

pub const fn with_complexity_validation(self, enabled: bool) -> RequestValidator

Enable/disable complexity validation.

pub const fn with_max_aliases(self, max_aliases: usize) -> RequestValidator

Set maximum number of aliases per query.

pub fn analyze( &self, query: &str, ) -> Result<QueryMetrics, ComplexityValidationError>

Compute query metrics without enforcing any limits.

Returns QueryMetrics for the query. Used by CLI tooling (explain, cost commands) where raw metrics are needed without a hard rejection.

Errors

Returns ComplexityValidationError::MalformedQuery if the query cannot be parsed.

pub fn validate_query( &self, query: &str, ) -> Result<(), ComplexityValidationError>

Validate a GraphQL query string, enforcing configured limits.

Errors

Returns ComplexityValidationError if the query violates any validation rules.

pub fn validate_variables( &self, variables: Option<&Value>, ) -> Result<(), ComplexityValidationError>

Validate variables JSON.

Errors

Returns ComplexityValidationError if variables are not a JSON object or exceed MAX_VARIABLES_COUNT.

Panics

Cannot panic in practice — the expect on as_object() is guarded by a preceding is_object() check that returns Err first.

Trait Implementations

impl Clone for RequestValidator

fn clone(&self) -> RequestValidator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestValidator

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

Formats the value using the given formatter.

impl Default for RequestValidator

fn default() -> RequestValidator

Returns the “default value” for a type.