JSON-RPC 是一种无状态的、轻量级的远程过程调用(RPC)协议。它定义了几种数据结构及其处理规则。它使用 JSON(JavaScript Object Notation)作为数据格式,允许实现相同功能的程序以松散耦合的方式跨网络通信。
以下是一个简单的 JSON-RPC 使用 Python 的示例。我们将使用 jsonrpclib
这个库来创建一个 JSON-RPC 服务端和一个客户端。首先,你需要安装 jsonrpclib
:
pip install jsonrpclib-pelix
服务端代码示例
from jsonrpclib.SimpleJSONRPCServer import SimpleJSONRPCServer
# 定义一个简单的函数,将被远程调用
def add(a, b):return a + b
# 创建一个 RPC 服务器,监听本地的 8000 端口
server = SimpleJSONRPCServer(('localhost', 8000))
# 注册 add 函数,使其可以被远程调用
server.register_function(add, 'add')
# 开始接受 RPC 调用
print("Starting server...")
server.serve_forever()
客户端代码示例
import jsonrpclib
# 创建一个指向服务端的代理
server = jsonrpclib.Server('http://localhost:8000')
# 调用远程的 add 函数
result = server.add(5, 3)
# 打印结果
print("5 + 3 = ", result)
在上述代码中,服务端创建了一个监听 8000 端口的 JSON-RPC 服务器,并注册了一个 add
函数供远程调用。客户端创建了一个指向服务端的代理,并调用了 add
函数。
要运行这个示例,首先运行服务端代码,使其开始监听端口。然后运行客户端代码,你应该会看到客户端成功调用了服务端的 add
函数,并打印出了结果。
请注意,以上示例是基于 jsonrpclib-pelix
这个库的,而且是在同一个机器上运行的。在实际的生产环境中,服务端和客户端通常会运行在不同的机器上,你只需要将服务端的地址改为实际的服务器地址即可。