本文Yi收录至GitHub，推荐阅读 👉 Java随想录

微信公众号：Java随想录

分布式系统中，不同服务之间需要一种可靠的方式来通信。远程过程调用是一种常见的选择，而 JSON-RPC 是其中比较简单的一种。

这篇文章介绍 JSON-RPC 协议的核心内容，包括消息格式、错误处理和实际应用场景。

JSON-RPC 是一种无状态、轻量级的远程过程调用协议，使用 JSON 作为数据格式。它的设计目标就是简单——协议规范只有几页文档。

JSON 作为数据交换格式，几乎所有主流编程语言dou有良好的支持，包括 JavaScript、Python、Java、C#、Go 等。这使得 JSON-RPC Neng够轻松实现跨语言调用。

协议本身不绑定传输层，Ke以跑在 HTTP、WebSocket、TCP Socket 等各种消息传输环境上。开发者Ke以根据业务需求选择合适的传输方式。

JSON-RPC 有两个主要版本： 和 。

版本Zui早提出了基于 JSON 的 RPC 概念，但在规范性方面有所欠缺。 年发布的 版本Zuo了重要升级，加入了批量调用支持、统一的错误对象结构。两个版本通过 jsonrpc 字段来区分。

JSON-RPC 有几个值得注意的特点：

JSON-RPC 规范中使用了 RFC 定义的关键字：MUST、MUST NOT、SHOULD、SHOULD NOT、MAY。这些术语描述了实现者必须、应该或Ke以遵循的行为规范。

客户端发起请求的实体，负责构造请求对象并处理响应。

服务端接收请求并返回响应的实体，处理请求并生成响应。

同一个实现Ke以同时扮演客户端和服务端。比如在对等网络中，两个节点可Neng既向对方发起请求，也响应来自对方的请求。

JSON-RPC 继承自 JSON 的类型系统，包含六种数据类型：

基本类型：String、Number、Boolean、Null

结构化类型：Object、Array

这些类型名称首字母必须大写，包括 True 和 False。

成员名称在客户端与服务端之间交换时必须区分大小写。函数、方法、过程这三个术语Ke以互换使用，dou指向Ke以被调用的可执行单元。

说实话，理解这些消息类型是使用JSON-RPC的关键。

JSON-RPC 定义了三种核心消息类型：请求对象响应对象 和 通知对象。

咱就是说请求对象的设计hen直观，一kan就明白。

jsonrpc: 指定协议版本，必须是字符串"

method: 方法名称，以rpc.

params: 方法参数，可选，Ke以是数组或对象两种形式

"索引数组": 按参数顺序传递，例如

"命名参数": 通过键值对传递，例如{ "value": 1, "message": "hello" }

"id": "req-001"

{
    "jsonrpc": "2.0",
    "method": "subtract",
    "params": ,
    "id": 1
}

{
    // 使用数组传参
    "jsonrpc": "",
    "method": "",
    "params": ,
    // 使用对象传参
    {
        // 方法名
        // 参数对象
        // 请求ID
}

// 错误示范 - 不要使用小数作为id{"jsonrpc": "", "method": "example", "params": , "id": .}

{
}

{
}

{
}