Struct axum_serde::sonic::Sonic
source · pub struct Sonic<T>(pub T);
Expand description
JSON 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/json
(or similar) header. - The body doesn’t contain syntactically valid JSON .
- The body contains syntactically valid JSON but it couldn’t be deserialized into the target type.
- Buffering the request body fails.
⚠️ Since parsing JSON requires consuming the request body, the Sonic 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::Sonic;
use serde::Deserialize;
#[derive(Deserialize)]
struct CreateUser {
email: String,
password: String,
}
async fn create_user(Sonic(payload): Sonic<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
JSON
, and will automatically set Content-Type: application/json
header.
§Response example
use axum::{
extract::Path,
routing::get,
Router,
};
use axum_serde::Sonic;
use serde::Serialize;
use uuid::Uuid;
#[derive(Serialize)]
struct User {
id: Uuid,
username: String,
}
async fn get_user(Path(user_id) : Path<Uuid>) -> Sonic<User> {
let user = find_user(user_id).await;
Sonic(user)
}
async fn find_user(user_id: Uuid) -> User {
// ...
}
let app = Router::new().route("/users/:id", get(get_user));
Tuple Fields§
§0: T
Implementations§
source§impl<T> Sonic<T>
impl<T> Sonic<T>
sourcepub fn into_inner(self) -> T
pub fn into_inner(self) -> T
Consumes the Sonic
extractor and returns the inner data.
sourcepub const CONTENT_TYPE: &'static str = $content_type
pub const CONTENT_TYPE: &'static str = $content_type
Content type of JSON format.
sourcepub fn from_bytes(bytes: &[u8]) -> Result<Self, Rejection<Error>>where
T: DeserializeOwned,
pub fn from_bytes(bytes: &[u8]) -> Result<Self, Rejection<Error>>where
T: DeserializeOwned,
Construct a Sonic<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 Sonic<T>
.
Trait Implementations§
source§impl<T, S> FromRequest<S> for Sonic<T>
impl<T, S> FromRequest<S> for Sonic<T>
source§impl<T> IntoResponse for Sonic<T>where
T: Serialize,
impl<T> IntoResponse for Sonic<T>where
T: Serialize,
source§fn into_response(self) -> Response
fn into_response(self) -> Response
impl<T: Copy> Copy for Sonic<T>
Auto Trait Implementations§
impl<T> Freeze for Sonic<T>where
T: Freeze,
impl<T> RefUnwindSafe for Sonic<T>where
T: RefUnwindSafe,
impl<T> Send for Sonic<T>where
T: Send,
impl<T> Sync for Sonic<T>where
T: Sync,
impl<T> Unpin for Sonic<T>where
T: Unpin,
impl<T> UnwindSafe for Sonic<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
source§impl<T, S> Handler<IntoResponseHandler, S> for T
impl<T, S> Handler<IntoResponseHandler, S> for T
source§fn call(
self,
_req: Request<Body>,
_state: S
) -> <T as Handler<IntoResponseHandler, S>>::Future
fn call( self, _req: Request<Body>, _state: S ) -> <T as Handler<IntoResponseHandler, S>>::Future
source§fn layer<L>(self, layer: L) -> Layered<L, Self, T, S>where
L: Layer<HandlerService<Self, T, S>> + Clone,
<L as Layer<HandlerService<Self, T, S>>>::Service: Service<Request<Body>>,
fn layer<L>(self, layer: L) -> Layered<L, Self, T, S>where
L: Layer<HandlerService<Self, T, S>> + Clone,
<L as Layer<HandlerService<Self, T, S>>>::Service: Service<Request<Body>>,
tower::Layer
to the handler. Read moresource§fn with_state(self, state: S) -> HandlerService<Self, T, S>
fn with_state(self, state: S) -> HandlerService<Self, T, S>
Service
by providing the statesource§impl<H, T> HandlerWithoutStateExt<T> for H
impl<H, T> HandlerWithoutStateExt<T> for H
source§fn into_service(self) -> HandlerService<H, T, ()>
fn into_service(self) -> HandlerService<H, T, ()>
Service
and no state.source§fn into_make_service(self) -> IntoMakeService<HandlerService<H, T, ()>>
fn into_make_service(self) -> IntoMakeService<HandlerService<H, T, ()>>
MakeService
and no state. Read moresource§fn into_make_service_with_connect_info<C>(
self
) -> IntoMakeServiceWithConnectInfo<HandlerService<H, T, ()>, C>
fn into_make_service_with_connect_info<C>( self ) -> IntoMakeServiceWithConnectInfo<HandlerService<H, T, ()>, C>
MakeService
which stores information
about the incoming connection and has no state. Read more