OF.JsonRpc (.NET轻量级服务框架)

Posted OF_Project

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了OF.JsonRpc (.NET轻量级服务框架)相关的知识,希望对你有一定的参考价值。

本项目是按照 《JSON-RPC 2.0 Specification》 的 .NET 实现, 它是基于 HTTP 或 TCP 或本地调用方式实现的轻量级松耦合的远程调用服务框架,提供了高效可用、无侵入式的方式搭建自己的服务平台,可以快速开发、调试、发布、调用服务,保持轻量级及可定制性。可以基于它构建 .NET 平台的微服务或 API。

重要特性

  • 支持目前支持 HTTP 和本地调用
  • 强大的自动的服务描述说明
  • 支持 RSA 和自定义授权机制
  • 支持自定义上下文

如何开发实现服务

1.创建新的或使用原有的 Class Library 工程,如OF.Microservices.DemoService ,该工程并不要求引用外部依赖包 OF.JsonRpc.dll ,然后在项目属性中进行设置, build 属性页 > Output > 勾选中 Xml documentation file,以便能自动生成在线文档。

2.在刚才创建的 OF.JsonRpc 工程中,创建一个自己的的服务类,并写一个 public的方法,写加入相应的注释,如下:

namespace OF.Microservices.DemoService
{
    /// <summary>
    /// 演示服务1
    /// </summary>
    public class Demo1
    {
        /// <summary>
        /// 输出两个参数的值
        /// </summary>
        /// <param name="param1">参数1</param>
        /// <param name="param2">参数2</param>
        /// <returns>返回参数1和参数2的信息</returns>
        public string Method1(string param1, string param2)
        {
            return $"param1: {param1}, param2: {param2}";
        }
    }
}

3.将本项目中的工程 OF.Microservices.Host 设为 IIS 的 Web 站点。并配置 jsonrpc.config 文件,在 serviceAssemblies 节点下配置需要暴露的服务实现 dll 程序集名称,jsonrpc.config 配置文件示例如下:

<?xml version="1.0" encoding="utf-8" ?>
<jsonrpc>
  <serviceAssemblies>
    <add assembly="OF.Microservices.DemoService" domain="Demo" methodMode="allPublic" subdomainTrimChars="Service" />
  </serviceAssemblies>
</jsonrpc>

4.然后用浏览器打开该网站的根地址,如:http://localhost:60282 即可查看服务的说明文档。

5.服务暴露的地址形如: http://localhost:60282/json.rpc

客户端 C# 的调用

详细请参见 OF.JsonRpc\OF.JsonRpc.ClientTest\CallDemoTest.cs 中的代码。需要在客户端引入 OF.JsonRpc.Client 程序集,并在 app.config/web.config 配置服务地址:

<configuration>
  <appSettings>
    <add key="JsonRpcServiceUrl" value="http://localhost:60282/json.rpc" />
  </appSettings>

调用的代码很简单,并不需要定义什么接口,完全松耦合的方式,Rpc.Call对应的参数为方法名及按顺序的参数即可。 示例如下:

// 调用服务,输入2个参数,返回一个字符串
var result1 = Rpc.Call<string>(
    "Demo.Demo1.Method1",
    "Jack","John");

// 调用服务,无返回值
Rpc.Call("Demo.Demo1.Method2", "Jack");

// 调用服务,返回一个匿名 dynamic 对象
var result = Rpc.Call<dynamic>(
    "Demo.Demo1.Method3", //JSON-RPC方法名
    new 
    {
        Name = "Jack",
        Email = "[email protected]",
        MobilePhone = "12306"
    }); // JSON-RPC的参数,
Console.WriteLine("result value, OrderNumber:" + result.OrderId);
Console.WriteLine("Customer.UserName:" + result.Customer.Name);
Console.WriteLine("Customer.Email:" + result.Customer.Email);
Console.WriteLine("Customer.MobilePhone:" + result.Customer.MobilePhone);

// 异常处理
try
{
    var result1 = Rpc.Call<string>(
        "Demo.Demo1.Method1",
        "Jack","John");
    Console.WriteLine("result value:" + result1);
}
catch (JsonRpcException jsonRpcException)
{
    if (jsonRpcException.code == 32000)
        Console.WriteLine("result business excetion:" + jsonRpcException.message);
    else
        Console.WriteLine("调用服务发生异常,{0}, {1}", jsonRpcException.message, jsonRpcException.data);
}

// 将参数为命名的对象属性进行调用
string result2 = Rpc.CallWithDeclaredParams<string>(
   "Demo.Demo1.Method1",
   new { param2 = "John", param1 = "Jack" });

 

浏览 JSON-RPC Help 文档

打开浏览器地址: http://localhost:60282 后进行文档首页,可以过滤

 技术分享图片

进入方法的详细说明: 

技术分享图片

进入参数或返回值的类型说明: 

技术分享图片

Java 调用

因为使用的统一的 JSON-RPC HTTP 协议,所以使用一些三方的库,推荐:https://github.com/briandilley/jsonrpc4j

JsonRpcHttpClient client = new JsonRpcHttpClient(
    new URL("http://example.com/UserService.json"));

User user = client.invoke("createUser", new Object[] { "bob", "the builder" }, User.class);

javascript 调用

,所以使用一些三方的库,推荐:https://github.com/datagraph/jquery-jsonrpc

示例:

$.jsonRPC.request(‘method.name‘, {
  params: params,
  success: function(result) {
    // Do something with the result here
    // It comes back as an RPC 2.0 compatible response object
  },
  error: function(result) {
    // Result is an RPC 2.0 compatible response object
  }
});

TODOLIST

  • 引入 Zookeeper 作为服务发现机制的选择之一
  • 支持跨服务调用的分布式事务支持
  • 加入 .NET Core 版本
  • 可以不用 IIS 宿主

以上是关于OF.JsonRpc (.NET轻量级服务框架)的主要内容,如果未能解决你的问题,请参考以下文章

MassTransit一个优秀的.NET消息(事件)总线框架

轻量级的Web框架——Nancy

asp.net core 3.0 gRPC框架小试

Dapr + .NET 实战服务调用之GRPC

.NET轻量级ORM框架Dapper入门精通

.NET轻量级ORM框架Dapper入门精通