Field class

Customizes schema generation for a specific field or parameter.

Apply this annotation to class fields or constructor parameters to provide additional schema metadata.

@Spectra()
class User {
  @Field(
    description: 'User email address',
    format: StringFormat.email,
  )
  final String email;

  @Field(
    description: 'User age',
    minimum: 0,
    maximum: 150,
  )
  final int age;
}

Constructors

Field({String? name, String? description, bool deprecated = false, List<Object>? examples, int? minLength, int? maxLength, String? pattern, StringFormat? format, num? minimum, num? maximum, bool exclusiveMinimum = false, bool exclusiveMaximum = false, num? multipleOf, int? minItems, int? maxItems, bool uniqueItems = false})
Creates a new Field annotation.
const

Properties

deprecated → bool
Mark this field as deprecated.
final
description → String?
Description of this field.
final
examples → List<Object>?
Example values for this field.
final
exclusiveMaximum → bool
Whether the maximum is exclusive.
final
exclusiveMinimum → bool
Whether the minimum is exclusive.
final
format → StringFormat?
Format hint for string values.
final
hashCode → int
The hash code for this object.
no setterinherited
maximum → num?
Maximum value for numeric types.
final
maxItems → int?
Maximum number of items in an array.
final
maxLength → int?
Maximum length for string values.
final
minimum → num?
Minimum value for numeric types.
final
minItems → int?
Minimum number of items in an array.
final
minLength → int?
Minimum length for string values.
final
multipleOf → num?
Value must be a multiple of this number.
final
name → String?
Override the property name in the schema.
final
pattern → String?
Regular expression pattern for string validation.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
uniqueItems → bool
Whether array items must be unique.
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited