太阳宝宝 发表于 2024-4-25 13:48:53

Taurus.MVC 微服务框架 入门开发教程:项目集成:7、微服务间的调用方式(

前言:

今天补充一下 Taurus.MVC 微服务教程,介绍一下微服务中针对RPC方面调整或新增的功能。
之前系列文章目录:
Taurus.MVC 微服务框架 入门开发教程:项目集成:1、服务端:注册中心、网关(提供可运行程序下载)。
Taurus.MVC 微服务框架 入门开发教程:项目集成:2、客户端:ASP.NET Core(C#)项目集成:应用中心。
Taurus.MVC 微服务框架 入门开发教程:项目集成:3、客户端:其它编程语言项目集成:Java集成应用中心。
Taurus.MVC 微服务框架 入门开发教程:项目集成:4、默认安全认证与自定义安全认证。
Taurus.MVC 微服务框架 入门开发教程:项目集成:5、统一的日志管理。
Taurus.MVC 微服务框架 入门开发教程:项目集成:6、微服务间的调用方式:Rpc.StartTaskAsync。
在当前版本的 Taurus.MVC 中,变更了 Rpc 的调用方式,同时引入了微服务间调用的程序集生成下载,或代码引用。
下面一起看看相关的介绍。
1、Taurus.MVC 微服务 Rpc 的调用方式变更说明:

A、名称空间变更:

Rpc 相关功能,从微服务 Taurus.MicroService 名称空间变更到 Taurus.Plugin.Rpc 名称空间下。<br>B、调用方式变更:

调用方式:从Rpc.XXXAsync 变更为:Rest.XXXAsync 系列,起手势有点小变,方法不变。<br>C、增加同步调用方法:

例如:
方法:Rest.StartTaskAsync(......) 对应异步
方法:Rest.StartTask(......) 对应同步下面是一个使用示例:
public void Start()
{
    string postUrl = "http://192.168.100.11:27257/api/port";
    RpcTaskRequest request = new RpcTaskRequest();
    request.HttpMethod = "GET";
    request.Url = postUrl;
    RpcTaskResult result = Rest.StartTask(request);
    if (result.Headers.Count > 0)
    {
      Response.AppendHeader("Port", result.Headers["Port"]);
    }
    Write(result.Text);
    return;
}整体说明:

Taurus.Plugin.Rpc.Rest 类提供一种基于REST方式的高性能的调用方法,适用于微服务间的调用,也适用于平时的网络请求,作为微服务间的通讯基础。

由于后续针对Taurus.MVC 微服务增加了新的封装调用方式,微服务间的调用将不再直接使用Rest调用,而是采用下面封装好的类库。2、Taurus.MVC 微服务 演示示例启动:

对于常规的 Rpc 远程调用,如gRpc等,通常需要编写很多代码或配置项,这将很大程度影响开发效率。
而 Taurus.MVC 将解决这一点,可以直接在注册中心下载封装好的 Rpc调用类库。
为了演示,下面将启动示例程序:
1、启动微服务注册中心:(这里监听 8000 端口)


2、启动微服务客户端A:(从启动项中可看出只注册了 /api/ 服务)


3、Taurus.MVC 微服务 Rpc 的调用方式二:下载程序集:

下面教和演示如何下载程序集:
1、首先进入注册中心管理后台:在微服服主菜单 MS-Host 中如下图

管理后台默认路径:/admin/login

2、点击 api 模块接口,在下方的列表中点击 Download:

将引出以下界面,该界面可以自定义生成的 dll 名称(同时也影响名称空间)

按默认,直接点确定,即可下载:

默认浏览器会对dll类型做出提示,常规操作正常保留即可。 

重点说明:

动态生成的 dll 运行时版本,将和微服务客户端的版本一致:

比如微服务客户端是部署成.NET8,那么生成的dll,只能在>=Net8的版本使用。

如果其它调用端的版本低怎么办?

下面会介绍介绍代码模式来解决这个问题。4、Taurus.MVC 微服务 Rpc 的调用方式二:使用程序集:

接下来,我们可以在任意的其它微服务客户端中,引用该下载的dll,即可实现调用客户端,
在引用调用微服务之前,我们需要先将运行环境配置好,确保自身也是微服务客户端环境。
下面进行演示示例(以 .NET 8 为示例):
1、新建空项目,并引用 Taurus.MVC:


2、启用 Taurus.MVC

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddTaurusMvc();
var app = builder.Build();
app.UseTaurusMvc();
app.UseStaticFiles();
app.Run();3、进入管理后台,将项目调整为微服务客户端

新建如下两个文件夹,只有存在Views文件夹,MVC框架才会生成管理后台。

管理后台默认路径:/admin/login

填写配置,启动微服务客户端,当然,也可以通过配置项启动:
{
"appSettings": {
    "MicroService.Client.Name": "*",
    "MicroService.Client.RcUrl": "http://192.168.100.105:8000"
}
}4、添加并使用RpcProxy类库:

在程序中引用下载的RpcProxy.dll,然后类库基本信息见如下图:

A、名称空间:Taurus.Plugin.MicroService.Proxy 这是基本名称空间。

B、RpcProxy 类为下载的 dll 名称。

C、API 为客户端注册的模块名。

D、API 下面的方法为接口名称。

E、API 下面的类名(以Para结尾)则为对应方法的参数类 了解了基本的信息,下面看一个简单示例:
public class RpcController : Taurus.Mvc.Controller
{
    public string GetHelloResult()
    {

      var rpcTask = RpcProxy.API.Hello(null);
      if (rpcTask.Result.IsSuccess)
      {
            return rpcTask.Result.Text;
      }
      else
      {
            return "None";
      }

    }
}调用输出结果:

对于调用 Hello 方法的参数,如果不需要参数,也不需要特殊请求头,可以传null。 
再给一个演示示例,包含文件上传:
public string UploadFileResult()
{
    RpcProxy.API.FilePara filePara = new RpcProxy.API.FilePara();
    filePara.File = HttpPostedFileCreator.Create("a.webp");//图片默认在/wwwroot/目录下
    var rpcTask = RpcProxy.API.File(filePara);
    if(rpcTask.Result.IsSuccess)
    {
      return rpcTask.Result.Text;
    }
    else
    {
      return rpcTask.Result.Error.Message;
    }
}运行结果:

重点说明:

1、使用该类库前,需要确保引用了 Taurus.MVC,并确认运行环境也是微服务客户端。<br>
2、如果方法有参数,则有一个对的方法名+Para 类,如上的Hello方法对应的参数为:HelloPara 类。<br><br>3、如果方法没有参数,则由默认RestDefaultPara 参数类服务。<br><br>4、参数类除了自身的属性为对应的参数,还有一个Header参数,用于设置请求头。<br><br>5、涉及文件上传的,由 HttpPostedFileCreator.Create 方法来提供。4、Taurus.MVC 微服务 Rpc 的调用方式三:使用代码:

如果在整体微服务系列中,使用的 .NET 或 .NET Core 版本不一致,会导致其它客户端可能无法正确引用程序集,因此,框架代码了代码的方式。
下面看使用过程:
1、回到注册中心的管理后台:


2、点击ViewCode:

弹出以下提示,效果和下载 dll 的一致。

 点击确定:

默认看到的代码,没有格式化,可以浏览器右键并点击: 查看页面源代码(可以看到代码经过了格式化,整齐了很多)

3、在项目中新建一个类,比如 RpcProx.cs,然后把该代码Copy过去即可。 

其效果和直接引用下载的程序集是一致的。
目前为了简约,生成的dll程序集,或代码,是没有带注释的,若觉得对接口理解不清楚,可以在注册中心点击:ToDoc,即可进入接口文档。
总结:

新改进提供的Taurus Rpc 功能,可以简化微服务间的调用,不用再手动敲写模块名称、调用路径,及手动获取主机信息来实现负载均衡,这一切,由框架内置实现提供了。
新的Taurus Rpc 功能,将使得服务间的调用,更加轻松、简约、高效。

来源:https://www.cnblogs.com/cyq1162/p/18123872
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: Taurus.MVC 微服务框架 入门开发教程:项目集成:7、微服务间的调用方式(