系列文章
- .Net Core 分布式微服务框架介绍 - Jimu
- .Net Core 分布式微服务框架 - Jimu 添加 Swagger 支持
一、前言
近些年一直浸淫在 .Net 平台做企业应用开发，用过的 .Net 框架不多（具体数量不清，印象深刻的有 Asp.Net MVC，WPF，其他很多都是基于微软开发的框架做些封装而形成新的框架，大都是还没起好名就湮灭在历史长河中），而自己开发的框架倒是不少（5 - 8 套吧）， 换框架与换公司成正比（每换一家公司，至少换一套框架），很多都见不得人（当时觉得高大上，后来觉得很low）。 随波逐流从 winform 年代到现在热火朝天的微服务，网上阅读各式各样的博客、新闻、评论、代码，懂了点微服务的概念，结合网上开源代码和思想，勉强拼凑出一个没什么特色的微服务框架 - Jimu (中文名：积木)。
不过框架的特色就像乳沟，挤挤还是有的：Jimu 是一个基于.Net Core 2.0 简单易用的微服务框架，使用了大量的开源库, 支持分布式、高并发和负载均衡， 实现了服务治理和 RPC 调用。Jimu 在持续迭代开发中，很多功能还在排期（如可视化监控和管理工具，热更新，服务熔断、限流和降级 ...），如非爱折腾的高手，不建议上生产环境。正如其中文名 - 积木，希望用她来开发项目像搭积木一样简单快速可控，使项目安全可靠稳定，整体架构可拓展、高并发、分布式。
二、功能技术
- 服务注册：指定服务器地址，或通过扩展支持其他应用（如 consul - 已支持，redis， zookeeper）
- 服务发现：指定服务器地址，或通过扩展支持其他应用（如 consul - 已支持，redis ，zookeeper）
- 服务调用：使用 DotNetty 或 Flurl.Http 实现 RPC 调用
- 服务代理：Microsoft.CodeAnalysis 解析服务接口生成动态代理
- 健康监测：Quartz.Net 定时调度 Socket 任务检查服务器心跳
- 负载均衡：轮询算法（未实现的有： 加权轮询法， 最小连接数法，随机法，加权随机法，源地址哈希法）
- 授权认证：jose-jwt 实现 JWT 授权
- 序 列 化：Json.Net
- 系统日志：log4net、NLog
三、框架简图
如图所示，这里有四种角色：
- Client：各种客户端， 这是抽象的说法，只要访问了 ApiGateway 都属于客户端（手机、电脑 ...， 如果 Service Server1 和 Service Server2 访问了 ApiGateway 也属于客户端）
- ApiGateway： 服务网关，外部要经过它才可访问内部的服务。网关是非常重要的一个角色，他相当于外部和内部服务之间的中介，负责接受和响应外部请求，以及调用内部服务，还有服务治理等功能
- Service Discovery Server：负责保存已注册的服务，相当于服务的花名册， Service Server 注册服务就是向花名册记录自己的名称， ApiGateway 发现服务就是去花名册找有哪些已注册的服务
- Service Server：这就是微服务，所有业务需求都在这里实现
四、如何使用
服务注册与发现， 已经实现了两种方式：
- 不依赖第三方应用，直接注册到本地服务， 可参看 github 上的 Quick Start
- 依赖于 consul, 需要先启动 consul，然后服务注册 consul, ApiGateway 访问 consul 发现服务
下面用 consul 作为服务容器，演示怎么用 Jimu 实现一个分布式的微服务
1. 启动 consul
下载安装 consul https://www.consul.io/downloads.html
启动
consul agent -dev
2. 微服务项目
创建一个基于 .Net Core 2.0 的类库项目，并添加 jimu 依赖
Install-Package Jimu添加服务，引用空间： using Jimu;
[JimuServiceRoute("api/{Service}")] // RPC 调用路径
public class UserService : IJimuService
{
[JimuService(CreatedBy = "grissom")] // 指定服务的元数据, 该服务调用路径为 api/user/getname?id=
public string GetName(string id)
{
return $"user id {id}, name enjoy!";
}
}
3. 微服务服务端项目
创建一个基于 .Net Core 2.0 的控制台项目， 并添加 Jimu.Server 和 Jimu.Common.Discovery.ConsulIntegration 依赖
Install-Package Jimu.Server
Install-Package Jimu.Common.Discovery.ConsulIntegration在 Main 函数中添加服务器启动代码，引用空间： using Jimu.Server;
static void Main(string[] args)
{
var hostBuilder = new ServiceHostServerBuilder(new Autofac.ContainerBuilder())
.UseLog4netLogger()
.LoadServices("QuickStart.Services")
.UseDotNettyForTransfer("127.0.0.1", 8001)
.UseConsulForDiscovery("127.0.0.1", 8500, "JimuService")
;
using (var host = hostBuilder.Build())
{
host.Run();
Console.ReadLine();
}
}4. 微服务客户端（ApiGateway）项目
创建一个基于 .Net Core 2.0 的 Asp.Net Core Web 应用程序（可选择 API 项目模版），并添加 Jimu.Client 和Jimu.Common.Discovery.ConsulIntegration 依赖
Install-Package Jimu.Client
Install-Package Jimu.Common.Discovery.ConsulIntegration修改 Startup.cs 类的代码， 以便添加对 jimu 的支持
using Jimu.Client;
using Jimu.Client.ApiGateway;
public class Startup
{
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
public IConfiguration Configuration { get; }
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
//services.AddMvc();
services.UseJimu();
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
//app.UseMvc();
var host = new ServiceHostClientBuilder(new Autofac.ContainerBuilder())
.UseLog4netLogger()
.UsePollingAddressSelector()
.UseDotNettyForTransfer()
.UseServerHealthCheck(1)
.SetDiscoveryAutoUpdateJobInterval(1)
.UseConsulForDiscovery("127.0.0.1", 8500, "JimuService")
.Build();
app.UseJimu(host);
host.Run();
}
}5. 同时启动 服务端 和 客户端
然后在浏览器访问： http://localhost:58156/api/user/getname?id=666
6. 更多 demo
更多强悍的功能使用，请自己看 demo 领悟，由于时间有限，这里就不一一详解了，如果大家有兴趣，日后或者会有多篇幅和文档来介绍。
请下载 Jimu 源码, 或者下载项目 jimu.demo
五、源码
请到 github pull 源码，包含有“巨量” demo