JSON-RPC轻量级远程调用协议介绍及使用

青旅半醒 2022-08-26 01:20 114阅读 0赞

## ##

**JSON-RPC轻量级远程调用协议介绍及使用**

**目录**

[技术简介    1 ][1]

[一、JSON-RPC协议描述    1][JSON-RPC_1]

[二、JSON-RPC调用简单示例    1][JSON-RPC_1 1]

[2.1、服务器端Java调用示例    1][2.1_Java_1]

[2.2、Java客户端调用示例    2][2.2_Java_2]

[2.3、PHP客户端调用示例    2][2.3_PHP_2]

[2.3、JavaScript客户端调用示例    2][2.3_JavaScript_2]

[2.4、直接GET请求进行调用    2][2.4_GET_2]

[三、JSON-RPC总结    3][JSON-RPC_3]

[参考文档    3][3]

# 技术简介  #

json-rpc是基于json的跨语言远程调用协议，比xml-rpc、webservice等基于文本的协议传输数据格小；相对hessian、java-rpc等二进制协议便于调试、实现、扩展，是非常优秀的一种远程调用协议。目前主流语言都已有json-rpc的实现框架，java语言中较好的json-rpc实现框架有jsonrpc4j、jpoxy、json-rpc。三者之中jsonrpc4j既可独立使用，又可与spring无缝集合，比较适合于基于spring的项目开发。

# 一、JSON-RPC协议描述  #

json-rpc协议非常简单，发起远程调用时向服务端传输数据格式如下：

\{ "method":"sayHello","params":\["Hello JSON-RPC"\],"id":1\}

**参数说明：**

method： 调用的方法名

params： 方法传入的参数，若无参数则传入 \[\]

id ： 调用标识符，用于标示一次远程调用过程

服务器其收到调用请求，处理方法调用，将方法效用结果效应给调用方；返回数据格式：

{

"result": "Hello JSON-RPC",

"error": null,

"id": 1

}

**参数说明:**

result: 方法返回值，若无返回值，则返回null。若调用错误，返回null。

error ：调用时错误，无错误返回null。

id : 调用标识符，与调用方传入的标识符一致。

以上就是json-rpc协议规范，非常简单，小巧，便于各种语言实现。

# 二、JSON-RPC简单示例  #

## 2.1、服务器端Java调用示例  ##

jsonrpc4j服务器端java示例：

**public****class** HelloWorldServlet **extends** HttpServlet \{

**private****static****final****long***serialVersionUID* = 3638336826344504848L;

**private** JsonRpcServer rpcService = **null**;

@Override

**public****void** init(ServletConfig config) **throws** ServletException \{

**super**.init(config);

rpcService = **new** JsonRpcServer(**new** HelloWorldService(), HelloWorldService.**class**);

@Override

**protected****void** service(HttpServletRequest req, HttpServletResponse resp)

**throws** ServletException, IOException \{

rpcService.handle(req, resp);

## 2.2、Java客户端调用示例  ##

jsonrpc4j的Java客户端调用示例：

JsonRpcHttpClient client = **new** JsonRpcHttpClient(

**new** URL("http://127.0.0.1:8080/index.json"));

Map<String,String> headers = **new** HashMap<String,String>();

headers.put("name", "剑白");

client.setHeaders(headers);

String properties = client.invoke("getSystemProperties", **null**, String.**class**);

System.*out*.println(properties);

## 2.3、PHP客户端调用示例  ##

基于json-rpc-php的PHP客户端调用示例：

<?phpinclude(dirname(\_\_FILE\_\_)."/lib/client/JsonRpcClient.php");

$client=newJsonRpcClient("http://10.13.49.234:8080/index.json");

$response=$client\->getSystemProperties();

echo$response\->result;

## 2.3、JavaScript客户端调用示例  ##

基于jsonrpcjs的JavaScript客户端调用示例：

**var** rpc = **new** jsonrpc.JsonRpc('http://127.0.0.1:8080/index.json');

rpc.call('getSystemProperties', **function**(result)\{

alert(result);

\});

## 2.4、直接GET请求进行调用  ##

无需任何客户端，只需手工拼接参数进行远程调用，请求URL如下：

[http://127.0.0.1:8080/index.json?method=getSystemProperties&id=3325235235235&params=JTViJTVk][http_127.0.0.1_8080_index.json_method_getSystemProperties_id_3325235235235_params_JTViJTVk]

参数说明:

method : 方法名

params ：调用参数，json的数组格式\[\], 将参数需先进行url编码，再进行base64编码

id : 调用标识符，任意值。

# 三、JSON-RPC总结  #

json-rpc是一种非常轻量级的跨语言远程调用协议，实现及使用简单。仅需几十行代码，即可实现一个远程调用的客户端，方便语言扩展客户端的实现。服务器端有php、java、python、ruby、.net等语言实现，是非常不错的及轻量级的远程调用协议。

# 参考文档  #

[http://code.google.com/p/jsonrpc4j/][http_code.google.com_p_jsonrpc4j]

[http://json-rpc.org/wiki/implementations][http_json-rpc.org_wiki_implementations]

[http://en.wikipedia.org/wiki/JSON-RPC][http_en.wikipedia.org_wiki_JSON-RPC]

[https://github.com/gimmi/jsonrpcjs][https_github.com_gimmi_jsonrpcjs]

[http://bitbucket.org/jbg/php-json-rpc][http_bitbucket.org_jbg_php-json-rpc]

[https://github.com/Pozo/json-rpc-php][https_github.com_Pozo_json-rpc-php]

[https://github.com/subutux/json-rpc2php][https_github.com_subutux_json-rpc2php]

[1]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668340
[JSON-RPC_1]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668341
[JSON-RPC_1 1]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668342
[2.1_Java_1]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668343
[2.2_Java_2]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668344
[2.3_PHP_2]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668345
[2.3_JavaScript_2]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668346
[2.4_GET_2]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668347
[JSON-RPC_3]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668348
[3]: http://gubaojian.blog.163.com/blog/static/1661799082012101439591/#_Toc340668349
[http_127.0.0.1_8080_index.json_method_getSystemProperties_id_3325235235235_params_JTViJTVk]: http://127.0.0.1:8080/index.json?method=getSystemProperties&id=3325235235235&params=JTViJTVk
[http_code.google.com_p_jsonrpc4j]: http://code.google.com/p/jsonrpc4j/
[http_json-rpc.org_wiki_implementations]: http://json-rpc.org/wiki/implementations
[http_en.wikipedia.org_wiki_JSON-RPC]: http://en.wikipedia.org/wiki/JSON-RPC
[https_github.com_gimmi_jsonrpcjs]: https://github.com/gimmi/jsonrpcjs
[http_bitbucket.org_jbg_php-json-rpc]: http://bitbucket.org/jbg/php-json-rpc
[https_github.com_Pozo_json-rpc-php]: https://github.com/Pozo/json-rpc-php
[https_github.com_subutux_json-rpc2php]: https://github.com/subutux/json-rpc2php