Struct Json

Source

pub struct Json<T>(pub T);

Expand description

JSON Extractor / Response.

When used as an extractor, it can deserialize request bodies into some type that implements serde::de::DeserializeOwned. The request will be rejected (and a JsonRejection 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 Json extractor must be last if there are multiple extractors in a handler. See “the order of extractors”

See JsonRejection for more details.

§Extractor example

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

#[derive(Deserialize)]
struct CreateUser {
    email: String,
    password: String,
}

async fn create_user(extract::Json(payload): extract::Json<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.

If the Serialize implementation decides to fail or if a map with non-string keys is used, a 500 response will be issued whose body is the error message in UTF-8.

§Response example

use axum::{
    extract::Path,
    routing::get,
    Router,
    Json,
};
use serde::Serialize;
use uuid::Uuid;

#[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;
    Json(user)
}

async fn find_user(user_id: Uuid) -> User {
    // ...
}

let app = Router::new().route("/users/{id}", get(get_user));

Tuple Fields§

§0: T

Struct JsonCopy item path

§Extractor example

§Response example

Tuple Fields§

Implementations§

impl<T> Json<T>where T: DeserializeOwned,

pub fn from_bytes(bytes: &[u8]) -> Result<Json<T>, JsonRejection>

Trait Implementations§

impl<T> Clone for Json<T>where T: Clone,

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

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

impl<T> Debug for Json<T>where T: Debug,

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

impl<T> Default for Json<T>where T: Default,

fn default() -> Json<T>

impl<T> Deref for Json<T>

type Target = T

fn deref(&self) -> &<Json<T> as Deref>::Target

impl<T> DerefMut for Json<T>

fn deref_mut(&mut self) -> &mut <Json<T> as Deref>::Target

impl<T> From<T> for Json<T>

fn from(inner: T) -> Json<T>

impl<T, S> FromRequest<S> for Json<T>where T: DeserializeOwned, S: Send + Sync,

type Rejection = JsonRejection

async fn from_request( req: Request<Body>, state: &S, ) -> Result<Json<T>, <Json<T> as FromRequest<S>>::Rejection>

impl<T> IntoResponse for Json<T>where T: Serialize,

fn into_response(self) -> Response<Body>

impl<T> Copy for Json<T>where T: Copy,

Auto Trait Implementations§

impl<T> Freeze for Json<T>where T: Freeze,

impl<T> RefUnwindSafe for Json<T>where T: RefUnwindSafe,

impl<T> Send for Json<T>where T: Send,

impl<T> Sync for Json<T>where T: Sync,

impl<T> Unpin for Json<T>where T: Unpin,

impl<T> UnwindSafe for Json<T>where T: UnwindSafe,

Blanket Implementations§

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> CloneToUninit for Twhere T: Clone,

unsafe fn clone_to_uninit(&self, dst: *mut u8)

impl<T> From<!> for T

fn from(t: !) -> T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> FromRef<T> for Twhere T: Clone,

fn from_ref(input: &T) -> T

impl<T, S> Handler<IntoResponseHandler, S> for Twhere T: IntoResponse + Clone + Send + Sync + 'static,

type Future = Ready<Response<Body>>

fn call( self, _req: Request<Body>, _state: S, ) -> <T as Handler<IntoResponseHandler, S>>::Future

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 with_state(self, state: S) -> HandlerService<Self, T, S>

impl<H, T> HandlerWithoutStateExt<T> for Hwhere H: Handler<T, ()>,

fn into_service(self) -> HandlerService<H, T, ()>

fn into_make_service(self) -> IntoMakeService<HandlerService<H, T, ()>>

fn into_make_service_with_connect_info<C>( self, ) -> IntoMakeServiceWithConnectInfo<HandlerService<H, T, ()>, C>

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

fn in_current_span(self) -> Instrumented<Self> ⓘ

impl<T, U> Into<U> for Twhere U: From<T>,

fn into(self) -> U

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘwhere F: FnOnce(&Self) -> bool,

impl<T> Pointable for T

const ALIGN: usize = _

type Init = T

unsafe fn init(init: <T as Pointable>::Init) -> usize

unsafe fn deref<'a>(ptr: usize) -> &'a T

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

unsafe fn drop(ptr: usize)

impl<T> QuickClone<T> for Twhere T: Clone,

fn C(&self) -> T

impl<T> QuickToOwned for Twhere T: ToOwned,

type Owned = <T as ToOwned>::Owned

fn O(&self) -> <T as QuickToOwned>::Owned

impl<P, T> Receiver for Pwhere P: Deref<Target = T> + ?Sized, T: ?Sized,

Struct Json

impl<T> Json<T>
where T: DeserializeOwned,

impl<T> Clone for Json<T>
where T: Clone,

impl<T> Debug for Json<T>
where T: Debug,

impl<T> Default for Json<T>
where T: Default,

impl<T, S> FromRequest<S> for Json<T>
where T: DeserializeOwned, S: Send + Sync,

impl<T> IntoResponse for Json<T>
where T: Serialize,

impl<T> Copy for Json<T>
where T: Copy,

impl<T> Freeze for Json<T>
where T: Freeze,

impl<T> RefUnwindSafe for Json<T>
where T: RefUnwindSafe,

impl<T> Send for Json<T>
where T: Send,

impl<T> Sync for Json<T>
where T: Sync,

impl<T> Unpin for Json<T>
where T: Unpin,

impl<T> UnwindSafe for Json<T>
where T: UnwindSafe,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<T> CloneToUninit for T
where T: Clone,

impl<T> FromRef<T> for T
where T: Clone,

impl<T, S> Handler<IntoResponseHandler, S> for T
where T: IntoResponse + Clone + Send + Sync + 'static,

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>>,

impl<H, T> HandlerWithoutStateExt<T> for H
where H: Handler<T, ()>,

impl<T, U> Into<U> for T
where U: From<T>,

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

impl<T> QuickClone<T> for T
where T: Clone,

impl<T> QuickToOwned for T
where T: ToOwned,

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

impl<R> Rng for R
where R: RngCore + ?Sized,

fn random<T>(&mut self) -> T
where StandardUniform: Distribution<T>,

fn random_iter<T>(self) -> Iter<StandardUniform, Self, T> ⓘ
where Self: Sized, StandardUniform: Distribution<T>,

fn random_range<T, R>(&mut self, range: R) -> T
where T: SampleUniform, R: SampleRange<T>,

fn sample<T, D>(&mut self, distr: D) -> T
where D: Distribution<T>,

fn sample_iter<T, D>(self, distr: D) -> Iter<D, Self, T> ⓘ
where D: Distribution<T>, Self: Sized,

fn fill<T>(&mut self, dest: &mut T)
where T: Fill + ?Sized,

fn gen<T>(&mut self) -> T
where StandardUniform: Distribution<T>,

fn gen_range<T, R>(&mut self, range: R) -> T
where T: SampleUniform, R: SampleRange<T>,

impl<T> RngCore for T
where T: DerefMut, <T as Deref>::Target: RngCore,

impl<T> ToOwned for T
where T: Clone,

impl<T, U> TryFrom<U> for T
where U: Into<T>,

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

impl<R> TryRngCore for R
where R: RngCore,

fn unwrap_err(self) -> UnwrapErr<Self>
where Self: Sized,

fn read_adapter(&mut self) -> RngReadAdapter<'_, Self> ⓘ
where Self: Sized,

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

impl<T> CryptoRng for T
where T: DerefMut, <T as Deref>::Target: CryptoRng,

impl<T> ErasedDestructor for T
where T: 'static,

impl<R> TryCryptoRng for R
where R: CryptoRng,