Struct JsonRpcNotification 

pub struct JsonRpcNotification {
    pub jsonrpc: String,
    pub method: String,
    pub params: Option<Value>,
}

JSON-RPC 2.0 Notification Message

Represents a notification - a request that does not expect a response. Notifications are “fire and forget” messages used for events or one-way communication.

JSON-RPC 2.0 Specification Compliance

• jsonrpc: MUST be exactly “2.0”
• method: MUST be a String containing the name of the notification method
• params: MAY be omitted. If present, MUST be Structured values (Object) or Ordered values (Array)
• id: MUST NOT be present (this is what distinguishes notifications from requests)

Examples

use airsprotocols_mcp::protocol::{JsonRpcNotification, JsonRpcMessageTrait};
use serde_json::json;

// Notification with parameters
let notification = JsonRpcNotification::new(
    "user_logged_in",
    Some(json!({"user_id": 12345, "timestamp": "2025-07-28T10:30:00Z"}))
);

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

Fields

jsonrpc: String

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

method: String

Name of the notification method

params: Option<Value>

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

Implementations

impl JsonRpcNotification

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

Create a new JSON-RPC 2.0 notification

Parameters

• method: Name of the notification method
• params: Optional parameters (will be serialized as JSON)

Examples

use airsprotocols_mcp::protocol::JsonRpcNotification;
use serde_json::json;

let notification = JsonRpcNotification::new(
    "status_changed",
    Some(json!({"old_status": "pending", "new_status": "active"}))
);

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

Create and validate a new JSON-RPC 2.0 notification

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

Parameters

• method: Name of the notification method (must be non-empty)
• params: Optional parameters (will be serialized as JSON)

Returns

• Ok(JsonRpcNotification) - Valid notification created successfully
• Err(JsonRpcError) - Notification violates JSON-RPC 2.0 specification

Examples

use airsprotocols_mcp::protocol::JsonRpcNotification;
use serde_json::json;

let notification = JsonRpcNotification::new_validated(
    "status_changed",
    Some(json!({"old_status": "pending", "new_status": "active"}))
)?;

Trait Implementations

impl Clone for JsonRpcNotification

fn clone(&self) -> JsonRpcNotification

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonRpcNotification

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JsonRpcNotification

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonRpcMessageTrait for JsonRpcNotification

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 JsonRpcNotification

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

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 JsonRpcNotification