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、名称空间变更：

1. Rpc 相关功能，从微服务 Taurus.MicroService 名称空间变更到 Taurus.Plugin.Rpc 名称空间下。<br>

复制代码

B、调用方式变更：

1. 调用方式：从Rpc.XXXAsync 变更为：Rest.XXXAsync 系列，起手势有点小变，方法不变。<br>

复制代码

C、增加同步调用方法：

1. 例如：
2. 方法：Rest.StartTaskAsync(......） 对应异步
3. 方法：Rest.StartTask(......) 对应同步

复制代码

下面是一个使用示例：

1. public void Start()
2. {
3.     string postUrl = "http://192.168.100.11:27257/api/port";
4.     RpcTaskRequest request = new RpcTaskRequest();
5.     request.HttpMethod = "GET";
6.     request.Url = postUrl;
7.     RpcTaskResult result = Rest.StartTask(request);
8.     if (result.Headers.Count > 0)
9.     {
10.         Response.AppendHeader("Port", result.Headers["Port"]);
11.     }
12.     Write(result.Text);
13.     return;
14. }

复制代码

整体说明：

1. Taurus.Plugin.Rpc.Rest 类提供一种基于REST方式的高性能的调用方法，适用于微服务间的调用，也适用于平时的网络请求，作为微服务间的通讯基础。
3. 由于后续针对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类型做出提示，常规操作正常保留即可。 

重点说明：

1. 动态生成的 dll 运行时版本，将和微服务客户端的版本一致：
3. 比如微服务客户端是部署成.NET8，那么生成的dll，只能在>=Net8的版本使用。
5. 如果其它调用端的版本低怎么办？
7. 下面会介绍介绍代码模式来解决这个问题。

复制代码

4、Taurus.MVC 微服务 Rpc 的调用方式二：使用程序集：

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

2、启用 Taurus.MVC

1. var builder = WebApplication.CreateBuilder(args);
2. builder.Services.AddTaurusMvc();
3. var app = builder.Build();
4. app.UseTaurusMvc();
5. app.UseStaticFiles();
6. app.Run();

复制代码

3、进入管理后台，将项目调整为微服务客户端

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

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

填写配置，启动微服务客户端，当然，也可以通过配置项启动：

1. {
2.   "appSettings": {
3.     "MicroService.Client.Name": "*",
4.     "MicroService.Client.RcUrl": "http://192.168.100.105:8000"
5.   }
6. }

复制代码

4、添加并使用RpcProxy类库：

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

1. A、名称空间：Taurus.Plugin.MicroService.Proxy 这是基本名称空间。
3. B、RpcProxy 类为下载的 dll 名称。
5. C、API 为客户端注册的模块名。
7. D、API 下面的方法为接口名称。
9. E、API 下面的类名（以Para结尾）则为对应方法的参数类

复制代码

 了解了基本的信息，下面看一个简单示例：

1. public class RpcController : Taurus.Mvc.Controller
2. {
3.     public string GetHelloResult()
4.     {
6.         var rpcTask = RpcProxy.API.Hello(null);
7.         if (rpcTask.Result.IsSuccess)
8.         {
9.             return rpcTask.Result.Text;
10.         }
11.         else
12.         {
13.             return "None";
14.         }
16.     }
17. }

复制代码

调用输出结果：

对于调用 Hello 方法的参数，如果不需要参数，也不需要特殊请求头，可以传null。 
再给一个演示示例，包含文件上传：

1. public string UploadFileResult()
2. {
3.     RpcProxy.API.FilePara filePara = new RpcProxy.API.FilePara();
4.     filePara.File = HttpPostedFileCreator.Create("a.webp");//图片默认在/wwwroot/目录下
5.     var rpcTask = RpcProxy.API.File(filePara);
6.     if(rpcTask.Result.IsSuccess)
7.     {
8.         return rpcTask.Result.Text;
9.     }
10.     else
11.     {
12.         return rpcTask.Result.Error.Message;
13.     }
14. }

复制代码

运行结果：

重点说明：

1. 1、使用该类库前，需要确保引用了 Taurus.MVC，并确认运行环境也是微服务客户端。<br>
2. 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】 我们会及时删除侵权内容，谢谢合作！