Struct rocket::serde::json::Json [−][src]
pub struct Json<T>(pub T);
json
only.Expand description
The JSON guard: easily consume and return JSON.
Receiving JSON
Json
is both a data guard and a form guard.
Data Guard
To parse request body data as JSON , add a data
route argument with a
target type of Json<T>
, where T
is some type you’d like to parse from
JSON. T
must implement serde::Deserialize
.
use rocket::serde::json::Json; #[post("/user", format = "json", data = "<user>")] fn new_user(user: Json<User>) { /* ... */ }
You don’t need to use format = "json"
, but it may be what you want.
Using format = json
means that any request that doesn’t specify
“application/json” as its Content-Type
header value will not be routed to
the handler.
Form Guard
Json<T>
, as a form guard, accepts value and data fields and parses the
data as a T
. Simple use Json<T>
:
use rocket::form::{Form, FromForm}; use rocket::serde::json::Json; #[derive(FromForm)] struct User<'r> { name: &'r str, metadata: Json<Metadata> } #[post("/user", data = "<form>")] fn new_user(form: Form<User<'_>>) { /* ... */ }
Incoming Data Limits
The default size limit for incoming JSON data is 1MiB. Setting a limit
protects your application from denial of service (DoS) attacks and from
resource exhaustion through high memory consumption. The limit can be
increased by setting the limits.json
configuration parameter. For
instance, to increase the JSON limit to 5MiB for all environments, you may
add the following to your Rocket.toml
:
[global.limits]
json = 5242880
Sending JSON
If you’re responding with JSON data, return a Json<T>
type, where T
implements Serialize
from serde
. The content type of the response is
set to application/json
automatically.
use rocket::serde::json::Json; #[get("/users/<id>")] fn user(id: usize) -> Json<User> { let user_from_id = User::from(id); /* ... */ Json(user_from_id) }
Implementations
Consumes the JSON wrapper and returns the wrapped item.
Example
let string = "Hello".to_string(); let my_json = Json(string); assert_eq!(my_json.into_inner(), "Hello".to_string());
Trait Implementations
Asynchronously validates, parses, and converts an instance of Self
from the incoming request body data. Read more
Serializes the wrapped value into JSON. Returns a response with Content-Type
JSON and a fixed-size body with the serialized value. If serialization
fails, an Err
of Status::InternalServerError
is returned.
Returns Ok
if a Response
could be generated successfully. Otherwise,
returns an Err
with a failing Status
. Read more
Auto Trait Implementations
impl<T> RefUnwindSafe for Json<T> where
T: RefUnwindSafe,
impl<T> UnwindSafe for Json<T> where
T: UnwindSafe,