jsonrpc-sys 0.1.4

JSON-RPC 2.0 types.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use std::borrow::Cow;

use serde::{Deserialize, Deserializer, Serialize, Serializer};

use crate::Id;

/// A JSON-RPC 2.0 request.
#[derive(Debug, Clone)]
pub struct Request<'a, P> {
    /// The method to be invoked.
    pub method: Cow<'a, str>,
    /// The parameters to be passed to the method.
    pub params: P,
    /// The identifier associated with the request.
    pub id: Option<Id<'a>>,
}

impl<'a, P> Serialize for Request<'a, P>
where
    P: Serialize,
{
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        OutgoingRequest::from_request(self).serialize(serializer)
    }
}

impl<'de, 'a, P> Deserialize<'de> for Request<'a, P>
where
    'de: 'a,
    P: Deserialize<'de>,
{
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        IncomingRequest::deserialize(deserializer).and_then(IncomingRequest::into_request)
    }
}

#[derive(Serialize)]
struct OutgoingRequest<'a, P> {
    jsonrpc: &'a str,
    method: &'a str,
    params: &'a P,
    #[serde(skip_serializing_if = "Option::is_none")]
    id: Option<crate::Id<'a>>,
}

impl<'a, P> OutgoingRequest<'a, P> {
    fn from_request(req: &'a crate::Request<'_, P>) -> Self {
        Self {
            jsonrpc: "2.0",
            method: &req.method,
            params: &req.params,
            id: req.id.as_ref().map(Id::reborrow),
        }
    }
}

#[derive(Deserialize)]
struct IncomingRequest<'a, P> {
    #[serde(borrow)]
    jsonrpc: Cow<'a, str>,
    #[serde(borrow)]
    method: Cow<'a, str>,
    params: P,
    #[serde(borrow, default, deserialize_with = "deserialize_id")]
    id: Option<crate::Id<'a>>,
}

impl<'a, P> IncomingRequest<'a, P> {
    fn into_request<E>(self) -> Result<crate::Request<'a, P>, E>
    where
        E: serde::de::Error,
        P: serde::Deserialize<'a>,
    {
        if self.jsonrpc != "2.0" {
            return Err(E::invalid_value(
                serde::de::Unexpected::Str(&self.jsonrpc),
                &"2.0",
            ));
        }

        Ok(crate::Request {
            method: self.method,
            params: self.params,
            id: self.id,
        })
    }
}

/// Deserializes an `Id` from a JSON-RPC 2.0 request.
///
/// This deserialization function is useful to distinguish between a null id and no id
/// specified in a request.
fn deserialize_id<'de, D>(deserializer: D) -> Result<Option<crate::Id<'de>>, D::Error>
where
    D: Deserializer<'de>,
{
    let opt = Option::deserialize(deserializer)?;

    match opt {
        Some(some) => Ok(some),
        None => Ok(Some(Id::Null)),
    }
}

#[test]
#[cfg(test)]
fn null_id() {
    let request = r#"{"jsonrpc":"2.0","method":"","id":null}"#;
    let request: crate::Request<'_, Option<()>> = serde_json::from_str(request).unwrap();
    assert_eq!(request.id, Some(Id::Null));
}

#[test]
#[cfg(test)]
fn no_id() {
    let request = r#"{"jsonrpc":"2.0","method":""}"#;
    let request: crate::Request<'_, Option<()>> = serde_json::from_str(request).unwrap();
    assert_eq!(request.id, None);
}