Struct JsonRpcResponse 

pub struct JsonRpcResponse {
    pub jsonrpc: String,
    pub result: Option<Value>,
    pub error: Option<Value>,
    pub id: Option<RequestId>,
}

JSON-RPC 2.0 Response Message

Represents the response to a JSON-RPC request. Contains either a successful result or error information, but never both (mutual exclusion enforced by JSON-RPC spec).

JSON-RPC 2.0 Specification Compliance

• jsonrpc: MUST be exactly “2.0”
• result: MUST exist and contain the result if the call succeeded (omitted on error)
• error: MUST exist and contain error details if the call failed (omitted on success)
• id: MUST be the same as the request that triggered this response, or null for parse errors

Examples

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

// Success response
let success = JsonRpcResponse::success(
    json!({"result": "operation completed"}),
    RequestId::new_number(1)
);

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

Fields

jsonrpc: String

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

result: Option<Value>

Result of successful method invocation (mutually exclusive with error)

error: Option<Value>

Error information for failed method invocation (mutually exclusive with result)

id: Option<RequestId>

Request identifier from the original request (null for parse errors)

Implementations

impl JsonRpcResponse

pub fn success(result: Value, id: RequestId) -> Self

Create a successful JSON-RPC 2.0 response

Parameters

• result: The successful result of the method invocation
• id: Request identifier from the original request

Examples

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

let response = JsonRpcResponse::success(
    json!({"status": "ok", "data": [1, 2, 3]}),
    RequestId::new_string("req-456")
);

pub fn error(error: Value, id: Option<RequestId>) -> Self

Create an error JSON-RPC 2.0 response

Parameters

• error: Error information (should conform to JSON-RPC error object structure)
• id: Request identifier from the original request (None for parse errors)

Examples

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

let response = JsonRpcResponse::error(
    json!({"code": -32602, "message": "Invalid params"}),
    Some(RequestId::new_number(789))
);

pub fn error_standard( code: i32, message: &str, data: Option<Value>, id: Option<RequestId>, ) -> Self

Create a standardized JSON-RPC 2.0 error response

This function creates a properly formatted JSON-RPC 2.0 error response with the correct error object structure according to the specification.

Parameters

• code: JSON-RPC error code (use constants from error_codes module)
• message: Human-readable error message
• data: Optional additional error data
• id: Request identifier from the original request (None for parse errors)

Examples

use airsprotocols_mcp::protocol::{JsonRpcResponse, RequestId};
use airsprotocols_mcp::protocol::constants::error_codes;

let response = JsonRpcResponse::error_standard(
    error_codes::INVALID_PARAMS,
    "Missing required parameter 'name'",
    Some(serde_json::json!({"parameter": "name"})),
    Some(RequestId::new_number(123))
);

pub fn parse_error(message: &str, data: Option<Value>) -> Self

Create a parse error response (-32700)

pub fn invalid_request( message: &str, data: Option<Value>, id: Option<RequestId>, ) -> Self

Create an invalid request error response (-32600)

pub fn method_not_found(method: &str, id: Option<RequestId>) -> Self

Create a method not found error response (-32601)

pub fn invalid_params( message: &str, data: Option<Value>, id: Option<RequestId>, ) -> Self

Create an invalid params error response (-32602)

pub fn internal_error( message: &str, data: Option<Value>, id: Option<RequestId>, ) -> Self

Create an internal error response (-32603)

Trait Implementations

impl Clone for JsonRpcResponse

fn clone(&self) -> JsonRpcResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonRpcResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JsonRpcResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonRpcMessageTrait for JsonRpcResponse

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 JsonRpcResponse

fn eq(&self, other: &JsonRpcResponse) -> 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 JsonRpcResponse

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 JsonRpcResponse