Crate json_rpc2

Simple, robust and pragmatic facade for JSON-RPC2 services that is transport agnostic.

use json_rpc2::*;
use serde_json::Value;

struct ServiceHandler;
impl Service for ServiceHandler {
   fn handle(&self, req: &mut Request) -> Result<Option<Response>> {
       let mut response = None;
       if req.matches("hello") {
           let params: String = req.into_params()?;
           let message = format!("Hello, {}!", params);
           response = Some((req, Value::String(message)).into());
       }
       Ok(response)
   }
}

fn main() -> Result<()> {
   let service: Box<dyn Service> = Box::new(ServiceHandler {});
   let mut request = Request::new(
       "hello", Some(Value::String("world".to_string())));
   let services = vec![&service];
   let response = match Broker::handle(&services, &mut request) {
       Ok(response) => response,
       Err(e) => e.into(),
   };
   assert_eq!(
       Some(Value::String("Hello, world!".to_string())),
       response.into_result());
   Ok(())
}

When converting from incoming payloads use the from_* functions to convert JSON to a Request so that errors are mapped correctly.

Structs

Broker	Broker calls multiple services and always yields a response.
Request	JSON-RPC request.
Response	JSON-RPC response.
RpcError	Error information for response messages.

Enums

Error

Enumeration of errors.

Traits

Service

Trait for service handlers that maybe handle a request.

Functions

from_reader	Parse a JSON payload from an IO reader into a request.
from_slice	Parse a JSON payload from a byte slice into a request.
from_str	Parse a JSON payload from a string slice into a request.
from_value	Parse a JSON payload from a Value into a request.

Type Definitions

Result

Result type for service handler functions and internal library errors.