diesel/pg/types/
json.rs

1//! Support for JSON and `jsonb` values under PostgreSQL.
2
3extern crate serde_json;
4
5use std::io::prelude::*;
6
7use crate::deserialize::{self, FromSql};
8use crate::pg::{Pg, PgValue};
9use crate::serialize::{self, IsNull, Output, ToSql};
10use crate::sql_types;
11
12#[cfg(all(feature = "postgres_backend", feature = "serde_json"))]
13impl FromSql<sql_types::Json, Pg> for serde_json::Value {
14    fn from_sql(value: PgValue<'_>) -> deserialize::Result<Self> {
15        serde_json::from_slice(value.as_bytes()).map_err(|_| "Invalid Json".into())
16    }
17}
18
19#[cfg(all(feature = "postgres_backend", feature = "serde_json"))]
20impl ToSql<sql_types::Json, Pg> for serde_json::Value {
21    fn to_sql<'b>(&'b self, out: &mut Output<'b, '_, Pg>) -> serialize::Result {
22        serde_json::to_writer(out, self)
23            .map(|_| IsNull::No)
24            .map_err(Into::into)
25    }
26}
27
28#[cfg(all(feature = "postgres_backend", feature = "serde_json"))]
29impl FromSql<sql_types::Jsonb, Pg> for serde_json::Value {
30    fn from_sql(value: PgValue<'_>) -> deserialize::Result<Self> {
31        let bytes = value.as_bytes();
32        let first_byte = bytes
33            .first()
34            .ok_or("Received an empty response from the server")?;
35
36        if *first_byte != 1 {
37            return Err("Unsupported JSONB encoding version".into());
38        }
39        // That's an empty slice if there is only
40        // one response byte
41        serde_json::from_slice(&bytes[1..]).map_err(|_| "Invalid Json".into())
42    }
43}
44
45#[cfg(all(feature = "postgres_backend", feature = "serde_json"))]
46impl ToSql<sql_types::Jsonb, Pg> for serde_json::Value {
47    fn to_sql<'b>(&'b self, out: &mut Output<'b, '_, Pg>) -> serialize::Result {
48        out.write_all(&[1])?;
49        serde_json::to_writer(out, self)
50            .map(|_| IsNull::No)
51            .map_err(Into::into)
52    }
53}
54
55#[cfg(test)]
56mod tests {
57    use crate::deserialize::FromSql;
58    use crate::pg::{Pg, PgValue};
59    use crate::query_builder::bind_collector::ByteWrapper;
60    use crate::serialize::{Output, ToSql};
61    use crate::sql_types;
62    use crate::test_helpers::format_error;
63
64    #[diesel_test_helper::test]
65    fn json_to_sql() {
66        let mut buffer = Vec::new();
67        let mut bytes = Output::test(ByteWrapper(&mut buffer));
68        let test_json = serde_json::Value::Bool(true);
69        ToSql::<sql_types::Json, Pg>::to_sql(&test_json, &mut bytes).unwrap();
70        assert_eq!(buffer, b"true");
71    }
72
73    #[diesel_test_helper::test]
74    fn some_json_from_sql() {
75        let input_json = b"true";
76        let output_json: serde_json::Value =
77            FromSql::<sql_types::Json, Pg>::from_sql(PgValue::for_test(input_json)).unwrap();
78        assert_eq!(output_json, serde_json::Value::Bool(true));
79    }
80
81    #[diesel_test_helper::test]
82    fn bad_json_from_sql() {
83        let uuid: Result<serde_json::Value, _> =
84            FromSql::<sql_types::Json, Pg>::from_sql(PgValue::for_test(b"boom"));
85        assert_eq!(format_error(&*uuid.unwrap_err()), "Invalid Json");
86    }
87
88    #[diesel_test_helper::test]
89    fn no_json_from_sql() {
90        let uuid: Result<serde_json::Value, _> =
91            FromSql::<sql_types::Json, Pg>::from_nullable_sql(None);
92        assert_eq!(
93            format_error(&*uuid.unwrap_err()),
94            "Unexpected null for non-null column"
95        );
96    }
97
98    #[diesel_test_helper::test]
99    fn jsonb_to_sql() {
100        let mut buffer = Vec::new();
101        let mut bytes = Output::test(ByteWrapper(&mut buffer));
102        let test_json = serde_json::Value::Bool(true);
103        ToSql::<sql_types::Jsonb, Pg>::to_sql(&test_json, &mut bytes).unwrap();
104        assert_eq!(buffer, b"\x01true");
105    }
106
107    #[diesel_test_helper::test]
108    fn some_jsonb_from_sql() {
109        let input_json = b"\x01true";
110        let output_json: serde_json::Value =
111            FromSql::<sql_types::Jsonb, Pg>::from_sql(PgValue::for_test(input_json)).unwrap();
112        assert_eq!(output_json, serde_json::Value::Bool(true));
113    }
114
115    #[diesel_test_helper::test]
116    fn bad_jsonb_from_sql() {
117        let uuid: Result<serde_json::Value, _> =
118            FromSql::<sql_types::Jsonb, Pg>::from_sql(PgValue::for_test(b"\x01boom"));
119        assert_eq!(format_error(&*uuid.unwrap_err()), "Invalid Json");
120    }
121
122    #[diesel_test_helper::test]
123    fn bad_jsonb_version_from_sql() {
124        let uuid: Result<serde_json::Value, _> =
125            FromSql::<sql_types::Jsonb, Pg>::from_sql(PgValue::for_test(b"\x02true"));
126        assert_eq!(
127            format_error(&*uuid.unwrap_err()),
128            "Unsupported JSONB encoding version"
129        );
130    }
131
132    #[diesel_test_helper::test]
133    fn no_jsonb_from_sql() {
134        let uuid: Result<serde_json::Value, _> =
135            FromSql::<sql_types::Jsonb, Pg>::from_nullable_sql(None);
136        assert_eq!(
137            format_error(&*uuid.unwrap_err()),
138            "Unexpected null for non-null column"
139        );
140    }
141}
diesel/pg/types/json.rs

diesel/pg/types/
json.rs
