Struct Xml 

pub struct Xml<T>(pub T);

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 crate::Rejection 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 crate::Rejection for more details.

Extractor example

use axum::{
    routing::post,
    Router,
};
use axum_serde::Xml;
use serde::Deserialize;

#[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 axum_serde::Xml;
use serde::Serialize;
use uuid::Uuid;

#[derive(Serialize)]
struct User {
    id: Uuid,
    username: String,
}

async fn get_user(Path(user_id) : Path<Uuid>) -> Xml<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

Implementations

impl<T> Xml<T>

pub const CONTENT_TYPE: &'static str = $content_type

Content type of XML format.

pub fn into_inner(self) -> T

Consumes the Xml extractor and returns the inner data.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, Rejection<DeError>>

where T: DeserializeOwned,

Construct a Xml<T> from a byte slice. Most users should prefer to use the FromRequest impl but special cases may require first extracting a Request into Bytes then optionally constructing a Xml<T>.

Trait Implementations

impl<T: Clone> Clone for Xml<T>

fn clone(&self) -> Xml<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Xml<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Xml<T>

fn default() -> Xml<T>

Returns the “default value” for a type.

impl<T> Deref for Xml<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for Xml<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T> From<T> for Xml<T>

fn from(inner: T) -> Self

Converts to this type from the input type.

impl<T, S> FromRequest<S> for Xml<T>

where T: DeserializeOwned, S: Send + Sync,

type Rejection = Rejection<DeError>

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request(req: Request, state: &S) -> Result<Self, Self::Rejection>

Perform the extraction.

impl<T> IntoResponse for Xml<T>

where T: Serialize,

fn into_response(self) -> Response

Create a response.

impl<T: Copy> Copy for Xml<T>