Enum actix_form_data::Field

pub enum Field<T, E> {
    Array(Array<T, E>),
    Map(Map<T, E>),
    File(Box<dyn Fn(String, Mime, Pin<Box<dyn Stream<Item = Result<Bytes, Error>>>>) -> Pin<Box<dyn Future<Output = Result<T, E>>>>>),
    Bytes,
    Int,
    Float,
    Text,
}

The field type represents a field in the form-data that is allowed to be parsed.

Variants

Array(Array<T, E>)

Map(Map<T, E>)

File(Box<dyn Fn(String, Mime, Pin<Box<dyn Stream<Item = Result<Bytes, Error>>>>) -> Pin<Box<dyn Future<Output = Result<T, E>>>>>)

Bytes

Int

Float

Text

Implementations

impl<T, E> Field<T, E>

pub fn file<F, Fut>(f: F) -> Selfwhere
    F: Fn(String, Mime, Pin<Box<dyn Stream<Item = Result<Bytes, Error>>>>) -> Fut + Clone + 'static,
    Fut: Future<Output = Result<T, E>> + 'static,
    E: 'static,

Add a File field with a name generator.

The name generator will be called for each file matching this field’s key. Keep in mind that each key/file pair will have it’s own name-generator, so sharing a name-generator between fields is up to the user.

Example

let (tx, rx) = channel(1);
let form = Form::new().field("file-field", Field::file(move |_, _, mut stream| {
    let mut tx = tx.clone();
    async move {
        while let Some(res) = stream.next().await {
            if let Ok(bytes) = res {
                if let Err(_) = tx.send(bytes).await {
                    break;
                }
            }
        }
        Ok(()) as Result<_, Error>
    }
}));

pub const fn bytes() -> Self

Add a Bytes field to a form

Example

let form = Form::<(), Error>::new().field("text-field", Field::bytes());

pub const fn text() -> Self

Add a Text field to a form

Example

let form = Form::<(), Error>::new().field("text-field", Field::text());

pub const fn int() -> Self

Add an Int field to a form

Example

let form = Form::<(), Error>::new().field("int-field", Field::int());

pub const fn float() -> Self

Add a Float field to a form

Example

let form = Form::<(), Error>::new().field("float-field", Field::float());

pub fn array(field: Field<T, E>) -> Self

Add an Array to a form

Example

let form = Form::<(), Error>::new()
    .field(
        "array-field",
        Field::array(Field::text())
    );

pub const fn map() -> Map<T, E>

Add a Map to a form

Example

let form = Form::<(), Error>::new()
    .field(
        "map-field",
        Field::map()
            .field("sub-field", Field::text())
            .field("sub-field-two", Field::text())
            .finalize()
    );

Trait Implementations

impl<T, E> Debug for Field<T, E>

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

Formats the value using the given formatter.