Struct Json 

pub struct Json<T>(pub T);

A value stored as a PostgreSQL json / jsonb column.

Wrapping a value makes it a query parameter (encoded as jsonb) and lets it be decoded from a result column. See the crate documentation for the preferred #[derive(Json)] form and when to reach for this wrapper.

#[derive(FromRow)]
struct Something {
    id: i32,
    user: Json<HashMap<String, i32>>,
}

query_as!(Something, "SELECT id, user FROM something")
    .fetch_all(&pool)
    .await?;
query!("UPDATE something SET user = $1", something.user)
    .execute(&pool)
    .await?;

Tuple Fields

0: T

Implementations

impl<T> Json<T>

pub const fn new(value: T) -> Self

Wraps value so it is stored as jsonb.

pub fn into_inner(self) -> T

Unwraps the value.

Trait Implementations

impl<T> AsRef<T> for Json<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

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

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

impl<T> Deref for Json<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T> DerefMut for Json<T>

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

Mutably dereferences the value.

impl<T: Eq> Eq for Json<T>

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

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: DeserializeOwned> FromRow for Json<T>

fn from_row(row: &Row) -> Result<Self, Error>

Builds a value from a row.

impl<T: DeserializeOwned> FromSql for Json<T>

fn from_sql(oid: Oid, buf: &[u8]) -> Result<Self, Error>

Decodes a non-null value of type oid.

fn accepts(oid: Oid) -> bool

Whether this type can be decoded from a column of type oid.

fn from_sql_zoned(oid: Oid, buf: &[u8], zone: TimeZone) -> Result<Self, Error>

Decodes a non-null value, using zone to interpret zone-less temporal values (timestamp, date, time).

fn from_sql_null() -> Result<Self, Error>

Decodes SQL NULL.

impl<T: Hash> Hash for Json<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: PartialEq> PartialEq for Json<T>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T> RowShape for Json<T>

const SHAPE: &'static [ColumnSpec]

The columns this type expects.

impl<T> StaticType for Json<T>

const OID: Oid = JSONBOID

The PostgreSQL type OID of this Rust type.

const NULLABLE: bool = false

Whether this Rust type can represent SQL NULL (i.e. it is Option).

impl<T: PartialEq> StructuralPartialEq for Json<T>

impl<T: Serialize + Send + Sync> ToSql for Json<T>

fn encode(&self, buf: &mut BytesMut) -> Result<IsNull, Error>

Appends the binary representation of this value to buf, without a length prefix.

fn oid(&self) -> Oid

The PostgreSQL type OID of this value.