pub struct Xml<T>(pub T);
Expand description
XML Extractor / Response.
When used as an extractor, it can deserialize request bodies into some type that
implements serde::Deserialize
. The request will be rejected (and a [XmlRejection
] will
be returned) if:
- The request doesn’t have a
Content-Type: application/xml
(or similar) header. - The body doesn’t contain syntactically valid XML.
- The body contains syntactically valid XML but it couldn’t be deserialized into the target type.
- Buffering the request body fails.
Since parsing XML requires consuming the request body, the Xml
extractor must be
last if there are multiple extractors in a handler.
See “the order of extractors”
See [XmlRejection
] for more details.
§Extractor example
use axum::{
extract,
routing::post,
Router,
};
use serde::Deserialize;
use rustcms_axum_xml::Xml;
#[derive(Deserialize)]
struct CreateUser {
email: String,
password: String,
}
async fn create_user(Xml(payload): Xml<CreateUser>) {
// payload is a `CreateUser`
}
let app = Router::new().route("/users", post(create_user));
When used as a response, it can serialize any type that implements serde::Serialize
to
XML
, and will automatically set Content-Type: application/xml
header.
§Response example
use axum::{
extract::Path,
routing::get,
Router,
};
use serde::Serialize;
use uuid::Uuid;
use rustcms_axum_xml::Xml;
#[derive(Serialize)]
struct User {
id: Uuid,
username: String,
}
async fn get_user(Path(user_id) : Path<Uuid>) -> Json<User> {
let user = find_user(user_id).await;
Xml(user)
}
async fn find_user(user_id: Uuid) -> User {
// ...
}
let app = Router::new().route("/users/:id", get(get_user));
Tuple Fields§
§0: T
Trait Implementations§
Source§impl<T, S, B> FromRequest<S, B> for Xml<T>
impl<T, S, B> FromRequest<S, B> for Xml<T>
Source§impl<T> IntoResponse for Xml<T>where
T: Serialize,
impl<T> IntoResponse for Xml<T>where
T: Serialize,
Source§fn into_response(self) -> Response
fn into_response(self) -> Response
Create a response.
impl<T: Copy> Copy for Xml<T>
Auto Trait Implementations§
impl<T> Freeze for Xml<T>where
T: Freeze,
impl<T> RefUnwindSafe for Xml<T>where
T: RefUnwindSafe,
impl<T> Send for Xml<T>where
T: Send,
impl<T> Sync for Xml<T>where
T: Sync,
impl<T> Unpin for Xml<T>where
T: Unpin,
impl<T> UnwindSafe for Xml<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