Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）-Toy模板网

这篇具有很好参考价值的文章主要介绍了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 名称空间下。

B、调用方式变更：

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

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 端口）

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

2、启动微服务客户端A：（从启动项中可看出只注册了 /api/ 服务）

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

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

下面教和演示如何下载程序集：

1、首先进入注册中心管理后台：在微服服主菜单 MS-Host 中如下图

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

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

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

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

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

按默认，直接点确定，即可下载：

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

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

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

重点说明：

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

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

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

下面会介绍介绍代码模式来解决这个问题。

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

接下来，我们可以在任意的其它微服务客户端中，引用该下载的dll，即可实现调用客户端，

在引用调用微服务之前，我们需要先将运行环境配置好，确保自身也是微服务客户端环境。

下面进行演示示例（以 .NET 8 为示例）：

1、新建空项目，并引用 Taurus.MVC：

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

2、启用 Taurus.MVC

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddTaurusMvc();
var app = builder.Build();
app.UseTaurusMvc();
app.UseStaticFiles();
app.Run();

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

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

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

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

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

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

{
  "appSettings": {
    "MicroService.Client.Name": "*",
    "MicroService.Client.RcUrl": "http://192.168.100.105:8000"
  }
}

4、添加并使用RpcProxy类库：

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

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

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";
        }

    }
}

调用输出结果：

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

对于调用 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;
    }
}

运行结果：

Taurus.MVC 微服务框架入门开发教程：项目集成：7、微服务间的调用方式（调整）：引用程序集及代码下载（新增）

重点说明：

1、使用该类库前，需要确保引用了 Taurus.MVC，并确认运行环境也是微服务客户端。
2、如果方法有参数，则有一个对的方法名+Para 类，如上的Hello方法对应的参数为：HelloPara 类。

3、如果方法没有参数，则由默认RestDefaultPara 参数类服务。

4、参数类除了自身的属性为对应的参数，还有一个Header参数，用于设置请求头。

5、涉及文件上传的，由 HttpPostedFileCreator.Create 方法来提供。