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

  • Taurus.MVC 微服务框架 入门开发教程:项目集成:7、微服务间的调用方式(调整):引用程序集及代码下载(新增)已关闭评论
  • 54 次浏览
  • A+
所属分类:.NET技术
摘要

今天补充一下 Taurus.MVC 微服务教程,介绍一下微服务中针对RPC方面调整或新增的功能。


前言:

今天补充一下 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 方法来提供。

4、Taurus.MVC 微服务 Rpc 的调用方式三:使用代码:

如果在整体微服务系列中,使用的 .NET 或 .NET Core 版本不一致,会导致其它客户端可能无法正确引用程序集,因此,框架代码了代码的方式。

下面看使用过程:

1、回到注册中心的管理后台:

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

2、点击ViewCode:

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

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

 点击确定:

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

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

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

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

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

其效果和直接引用下载的程序集是一致的。

目前为了简约,生成的dll程序集,或代码,是没有带注释的,若觉得对接口理解不清楚,可以在注册中心点击:ToDoc,即可进入接口文档。

总结:

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

新的Taurus Rpc 功能,将使得服务间的调用,更加轻松、简约、高效。