Crate jsonrpc_macros

High level, typed wrapper for jsonrpc_core.

Enables creation of “Service” objects grouping a set of RPC methods together in a typed manner.

Example

extern crate jsonrpc_core;
#[macro_use] extern crate jsonrpc_macros;
use jsonrpc_core::{IoHandler, Error};
use jsonrpc_core::futures::{self, BoxFuture, Future};
build_rpc_trait! {
	pub trait Rpc {
		/// Returns a protocol version
		#[rpc(name = "protocolVersion")]
		fn protocol_version(&self) -> Result<String, Error>;

		/// Adds two numbers and returns a result
		#[rpc(name = "add")]
		fn add(&self, u64, u64) -> Result<u64, Error>;

		/// Performs asynchronous operation
		#[rpc(async, name = "callAsync")]
		fn call(&self, u64) -> BoxFuture<String, Error>;
	}
}
struct RpcImpl;
impl Rpc for RpcImpl {
	fn protocol_version(&self) -> Result<String, Error> {
		Ok("version1".into())
	}

	fn add(&self, a: u64, b: u64) -> Result<u64, Error> {
		Ok(a + b)
	}

	fn call(&self, _: u64) -> BoxFuture<String, Error> {
		futures::finished("OK".to_owned()).boxed()
	}
}

fn main() {
  let mut io = IoHandler::new();
  let rpc = RpcImpl;

  io.extend_with(rpc.to_delegate());
}

Re-exports

• pub extern crate jsonrpc_core;

Modules

• pubsub
  PUB-SUB auto-serializing structures.

Macros

• build_rpc_trait
• metadata
  Auto-generates an RPC trait from trait definition.

Structs

• IoDelegate
  A set of RPC methods and notifications tied to single delegate struct.
• Trailing
  A wrapper type without an implementation of Deserialize which allows a special implementation of Wrap for functions that take a trailing default parameter.

Functions

• to_value
  Converts a serializable value into Value.