Struct Input 

pub struct Input { /* private fields */ }

The named values under validation.

Implementations

impl Input

pub fn new() -> Self

pub fn from_json(value: &Json) -> Self

Take the top level of a JSON object.

A body that is not an object — an array, a bare string — has no named fields, so it validates as empty and required rules report what is missing. That is a better failure than a parse error the client cannot act on.

pub fn from_pairs<K: AsRef<str>, V: AsRef<str>>( pairs: impl IntoIterator<Item = (K, V)>, ) -> Self

Build from name/value pairs — a form body or a query string.

A repeated key becomes an array, because that is how a browser sends a group of checkboxes, and it is what makes array and a counting min work on one.

pub fn from_request(request: &mut Request) -> Self

Everything a request carries, in Request::input’s precedence order: the query string first, then a form body, then a JSON body on top.

pub fn merge(&mut self, other: Input)

Overlay another set of values, replacing any field they share.

pub fn insert(&mut self, name: impl Into<String>, value: impl Into<Json>)

pub fn with(self, name: impl Into<String>, value: impl Into<Json>) -> Self

The chaining form of Input::insert, for building an input in a test or from values the application already holds.

pub fn get(&self, name: &str) -> Option<&Json>

pub fn has(&self, name: &str) -> bool

Whether the field was sent at all. A field sent as null is present.

pub fn fields(&self) -> &BTreeMap<String, Json>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

Trait Implementations

impl Clone for Input

fn clone(&self) -> Input

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Input

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

Formats the value using the given formatter.

impl Default for Input

fn default() -> Input

Returns the “default value” for a type.

impl From<&Json> for Input

fn from(value: &Json) -> Self

Converts to this type from the input type.

impl From<Json> for Input

fn from(value: Json) -> Self

Converts to this type from the input type.

impl PartialEq for Input

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Input