jsonrpc-core 3.0.2

Transport agnostic rust implementation of JSON-RPC 2.0 Specification.
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

# jsonrpc-core
Transport agnostic rust implementation of JSON-RPC 2.0 Specification.

[![Build Status][travis-image]][travis-url]

[travis-image]: https://travis-ci.org/ethcore/jsonrpc-core.svg?branch=master
[travis-url]: https://travis-ci.org/ethcore/jsonrpc-core

[Documentation](http://ethcore.github.io/jsonrpc-core/jsonrpc_core/index.html)

- [x] - server side
- [x] - client side

## Example

`Cargo.toml`


```
[dependencies]
jsonrpc-core = "3.0"
```

`main.rs`

```rust
extern crate jsonrpc_core;

use jsonrpc_core::*;

struct SayHello;
impl SyncMethodCommand for SayHello {
    fn execute(&self, _params: Params) -> Result<Value, Error> {
        Ok(Value::String("hello".to_string()))
    }
}

fn main() {
	let io = IoHandler::new();
	io.add_method("say_hello", SayHello);

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_string()));
}
```

### Asynchronous responses

`main.rs`

```rust
extern crate jsonrpc_core;

use jsonrpc_core::*;

struct SayHello;
impl AsyncMethodCommand for SayHello {
    fn execute(&self, _params: Params, ready: Ready) {
        ready.ready(Ok(Value::String("hello".to_string())))
    }
}

fn main() {
	let io = IoHandler::new();
	io.add_async_method("say_hello", SayHello);

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

	io.handle_request(request).map(|async_response| {
		async_response.on_result(move |res| {
			assert_eq!(res, response.to_string());
		})
	});
}
```