Struct InputFieldDefinition 

pub struct InputFieldDefinition {
    pub name: String,
    pub field_type: String,
    pub nullable: bool,
    pub description: Option<String>,
    pub default_value: Option<String>,
    pub deprecation: Option<DeprecationInfo>,
    pub validation_rules: Vec<ValidationRule>,
}

A field within a GraphQL input object type.

Example

use fraiseql_core::schema::InputFieldDefinition;

let field = InputFieldDefinition::new("email", "String")
    .with_description("User's email address")
    .with_nullable(false); // required

Fields

name: String

Field name.

field_type: String

Field type (e.g., "String!", "[Int]", "UserFilter").

nullable: bool

Whether this input field is nullable (optional).

Drives required-field enforcement: a non-nullable field with no default must be supplied (and non-null) by the client or the request is rejected before the database call. Unlike the output FieldDefinition::nullable (which defaults to false), this defaults to true — GraphQL input fields are nullable unless explicitly marked non-null, and a missing key degrades safely to “optional” (no enforcement) rather than over-rejecting.

description: Option<String>

Description.

default_value: Option<String>

Default value (as JSON string).

deprecation: Option<DeprecationInfo>

Deprecation information (if this field is deprecated).

validation_rules: Vec<ValidationRule>

Validation rules applied to this field (from @validate directives).

Implementations

impl InputFieldDefinition

pub fn new(name: impl Into<String>, field_type: impl Into<String>) -> Self

Create a new input field.

pub fn with_description(self, description: impl Into<String>) -> Self

Set description.

pub const fn with_nullable(self, nullable: bool) -> Self

Set whether this field is nullable (optional). Defaults to true.

pub fn with_default_value(self, value: impl Into<String>) -> Self

Set default value.

pub fn deprecated(self, reason: Option<String>) -> Self

Mark this field as deprecated.

pub const fn is_deprecated(&self) -> bool

Check if this field is deprecated.

pub const fn is_required(&self) -> bool

Check if this field is required (non-nullable without default).

Driven by nullable, not the ! suffix of field_type: a filter operator field can have a non-null type (e.g. "[String!]!") yet be optional, so requiredness is tracked separately from the type string.

pub fn with_validation_rule(self, rule: ValidationRule) -> Self

Add a validation rule to this field.

pub fn with_validation_rules(self, rules: Vec<ValidationRule>) -> Self

Add multiple validation rules to this field.

pub const fn has_validation_rules(&self) -> bool

Check if this field has validation rules.

Trait Implementations

impl Clone for InputFieldDefinition

fn clone(&self) -> InputFieldDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InputFieldDefinition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InputFieldDefinition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for InputFieldDefinition

fn eq(&self, other: &InputFieldDefinition) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for InputFieldDefinition

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for InputFieldDefinition