Struct JsonRpcRequest 

pub struct JsonRpcRequest {
    pub jsonrpc: String,
    pub method: String,
    pub params: Option<Value>,
    pub id: RequestId,
}

JSON-RPC 2.0 Request Message

Represents a request to invoke a method on the remote peer. All fields are required except for params, which may be omitted if the method takes no parameters.

JSON-RPC 2.0 Specification Compliance

• jsonrpc: MUST be exactly “2.0”
• method: MUST be a String containing the name of the method to invoke
• params: MAY be omitted. If present, MUST be Structured values (Object) or Ordered values (Array)
• id: MUST be a String, Number, or NULL value

Examples

use airsprotocols_mcp::protocol::{JsonRpcRequest, JsonRpcMessageTrait, RequestId};
use serde_json::json;

// Request with parameters
let request = JsonRpcRequest::new(
    "subtract",
    Some(json!([42, 23])),
    RequestId::new_number(1)
);

// Use trait methods for serialization
let json = request.to_json().unwrap();
let parsed = JsonRpcRequest::from_json(&json).unwrap();
assert_eq!(request, parsed);

Fields

jsonrpc: String

Protocol version - always “2.0” for JSON-RPC 2.0 compliance

method: String

Name of the method to invoke

params: Option<Value>

Parameters for the method (null, object, or array)

id: RequestId

Unique identifier for this request

Implementations

impl JsonRpcRequest

pub fn new( method: impl Into<String>, params: Option<Value>, id: RequestId, ) -> Self

Create a new JSON-RPC 2.0 request

Parameters

• method: Name of the method to invoke
• params: Optional parameters (will be serialized as JSON)
• id: Unique request identifier

Examples

use airsprotocols_mcp::protocol::{JsonRpcRequest, RequestId};
use serde_json::json;

let request = JsonRpcRequest::new(
    "calculate",
    Some(json!({"operation": "add", "values": [1, 2, 3]})),
    RequestId::new_string("calc-123")
);

pub fn new_validated( method: impl Into<String>, params: Option<Value>, id: RequestId, ) -> Result<Self, JsonRpcError>

Create and validate a new JSON-RPC 2.0 request

This function performs validation during construction to catch invalid requests early.

Parameters

• method: Name of the method to invoke (must be non-empty)
• params: Optional parameters (will be serialized as JSON)
• id: Unique request identifier

Returns

• Ok(JsonRpcRequest) - Valid request created successfully
• Err(JsonRpcError) - Request violates JSON-RPC 2.0 specification

Examples

use airsprotocols_mcp::protocol::{JsonRpcRequest, RequestId};
use serde_json::json;

let request = JsonRpcRequest::new_validated(
    "calculate",
    Some(json!({"operation": "add", "values": [1, 2, 3]})),
    RequestId::new_string("calc-123")
)?;

Trait Implementations

impl Clone for JsonRpcRequest

fn clone(&self) -> JsonRpcRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JsonRpcRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JsonRpcRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonRpcMessageTrait for JsonRpcRequest

fn to_json(&self) -> Result<String, Error>

Serialize this message to JSON string

fn to_json_pretty(&self) -> Result<String, Error>

Serialize this message to pretty-printed JSON

fn from_json(json: &str) -> Result<Self, Error>

Deserialize from JSON string

fn serialize_to_buffer(&self, buffer: &mut BytesMut) -> Result<(), Error>

Zero-copy serialization to buffer

fn to_bytes(&self) -> Result<Bytes, Error>

Serialize this message to bytes

fn from_json_bytes(json: &[u8]) -> Result<Self, Error>

Deserialize a message from JSON bytes

impl PartialEq for JsonRpcRequest

fn eq(&self, other: &JsonRpcRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for JsonRpcRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for JsonRpcRequest