pub struct Form<T>(pub T);
Expand description
Form data helper (application/x-www-form-urlencoded
)
Can be use to extract url-encoded data from the request body, or send url-encoded data as the response.
§Extract
To extract typed information from request’s body, the type T
must
implement the Deserialize
trait from serde.
FormConfig allows to configure extraction process.
§Example
use ntex::web;
#[derive(serde::Deserialize)]
struct FormData {
username: String,
}
/// Extract form data using serde.
/// This handler get called only if content type is *x-www-form-urlencoded*
/// and content of the request could be deserialized to a `FormData` struct
fn index(form: web::types::Form<FormData>) -> String {
format!("Welcome {}!", form.username)
}
§Respond
The Form
type also allows you to respond with well-formed url-encoded data:
simply return a value of type Formserde::Serialize
;
§Example
use ntex::web;
#[derive(serde::Serialize)]
struct SomeForm {
name: String,
age: u8
}
// Will return a 200 response with header
// `Content-Type: application/x-www-form-urlencoded`
// and body "name=ntex&age=123"
fn index() -> web::types::Form<SomeForm> {
web::types::Form(SomeForm {
name: "ntex".into(),
age: 123
})
}
Tuple Fields§
§0: T
Implementations§
source§impl<T> Form<T>
impl<T> Form<T>
sourcepub fn into_inner(self) -> T
pub fn into_inner(self) -> T
Deconstruct to an inner value
Trait Implementations§
source§impl<T, Err> FromRequest<Err> for Form<T>where
T: DeserializeOwned + 'static,
Err: ErrorRenderer,
impl<T, Err> FromRequest<Err> for Form<T>where
T: DeserializeOwned + 'static,
Err: ErrorRenderer,
§type Error = UrlencodedError
type Error = UrlencodedError
The associated error which can be returned.
source§async fn from_request(
req: &HttpRequest,
payload: &mut Payload
) -> Result<Self, Self::Error>
async fn from_request( req: &HttpRequest, payload: &mut Payload ) -> Result<Self, Self::Error>
Convert request to a Self
source§impl<T: Ord> Ord for Form<T>
impl<T: Ord> Ord for Form<T>
source§impl<T: PartialEq> PartialEq for Form<T>
impl<T: PartialEq> PartialEq for Form<T>
source§impl<T: PartialOrd> PartialOrd for Form<T>
impl<T: PartialOrd> PartialOrd for Form<T>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for
self
and other
) and is used by the <=
operator. Read moresource§impl<T: Serialize, Err: ErrorRenderer> Responder<Err> for Form<T>
impl<T: Serialize, Err: ErrorRenderer> Responder<Err> for Form<T>
source§async fn respond_to(self, req: &HttpRequest) -> Response
async fn respond_to(self, req: &HttpRequest) -> Response
Convert itself to http response.
source§fn with_status(self, status: StatusCode) -> CustomResponder<Self, Err>where
Self: Sized,
fn with_status(self, status: StatusCode) -> CustomResponder<Self, Err>where
Self: Sized,
Override a status code for a Responder. Read more
source§fn with_header<K, V>(self, key: K, value: V) -> CustomResponder<Self, Err>where
Self: Sized,
HeaderName: TryFrom<K>,
HeaderValue: TryFrom<V>,
<HeaderName as TryFrom<K>>::Error: Into<HttpError>,
<HeaderValue as TryFrom<V>>::Error: Into<HttpError>,
fn with_header<K, V>(self, key: K, value: V) -> CustomResponder<Self, Err>where
Self: Sized,
HeaderName: TryFrom<K>,
HeaderValue: TryFrom<V>,
<HeaderName as TryFrom<K>>::Error: Into<HttpError>,
<HeaderValue as TryFrom<V>>::Error: Into<HttpError>,
Add header to the Responder’s response. Read more
impl<T: Eq> Eq for Form<T>
impl<T> StructuralPartialEq for Form<T>
Auto Trait Implementations§
impl<T> Freeze for Form<T>where
T: Freeze,
impl<T> RefUnwindSafe for Form<T>where
T: RefUnwindSafe,
impl<T> Send for Form<T>where
T: Send,
impl<T> Sync for Form<T>where
T: Sync,
impl<T> Unpin for Form<T>where
T: Unpin,
impl<T> UnwindSafe for Form<T>where
T: UnwindSafe,
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more