dotnet core微服务框架Jimu ~ 会员注册微服务

提供会员注册服务，用户必须注册成会员才能享受应用提供的服务，如浏览和发布新闻，但有些服务又需要指定角色的会员才能操作，如所有会员都可以浏览新闻，只有管理员(admin)角色的会员才可以发布新闻。

有 2 个公开的 api:

CheckName：判断用户名是否可用；
Register：根据用户名注册会员；

1 声明接口，创建基于 .Net Core 6.0 的类库项目，命名为 Register.IServices

1.1 添加 jimu 引用

Install-Package  Jimu

1.2 创建 dto 类

using System; using System.Collections.Generic; using System.Text;  namespace Register.IServices {     public class Member     {         public Guid Id { get; set; }         public string Name { get; set; }         public string NickName { get; set; }         public string Pwd { get; set; }      } }

1.3 声明公开的微服务接口

微服务的定义规则：

必须继承 IJimuService 接口
声明路由属性 [JimuServiceRoute()]
方法添加属性 [JimuService()]，该方法才会注册成公开的微服务

Jimu 支持异步方法，如下面的 Register

下面的两个方法，未设置 EnableAuthorization = true(默认为 false),都可以匿名访问

using System; using System.Threading.Tasks; using Jimu;  namespace Register.IServices {     [JimuServiceRoute("/api/v1/register")]     public interface IRegisterService : IJimuService     {         [JimuService(CreatedBy = "grissom", CreatedDate = "2018-07-17", Comment = "check member name whether is valid")]         bool CheckName(string name);         [JimuService(CreatedBy = "grissom", CreatedDate = "2018-07-17", Comment = "register member")]         Task<bool> Register(string name, string nickname, string pwd);      } }

2 实现接口，创建基于 .Net Core 6.0 的类库项目，命名为 Register.Services

2.1 添加对接口项目 Register.IServices 的引用

2.2 实现接口

using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Register.IServices;  namespace Register.Services {     public class RegisterService : IRegisterService     {         static List<Member> _membersDb = new List<Member>();          public bool CheckName(string name)         {             return !_membersDb.Any(x => x.Name == name);         }          public Task<bool> Register(string name, string nickname, string pwd)         {             if (!CheckName(name))             {                 return Task.FromResult(false);             }             _membersDb.Add(new Member { Id = Guid.NewGuid(), Name = name, NickName = nickname, Pwd = pwd });             return Task.FromResult(true);          }     } }

3 微服务的宿主服务器，创建基于 .Net Core 6.0 的控制台应用，命名为 Register.Server

3.1 添加对项目： Register.Services 的引用

3.2 添加 jimu.server 和 Jimu.Common.Discovery.ConsulIntegration 引用

Install-Package  Jimu.Server Install-Package  Jimu.Common.Discovery.ConsulIntegration

3.3 启动 jimu 服务代码

using Jimu.Server; using System;  namespace Register.Server {     class Program     {         static void Main(string[] args)         {             var builder = new ServiceHostServerBuilder(new Autofac.ContainerBuilder())              .UseLog4netLogger() // 使用 log4net 记录日志              .LoadServices("Register.IServices", "Register.Services") // 加载服务              .UseDotNettyForTransfer("127.0.0.1", 8001) // DotNetty 监听 8001 端口进行通讯              .UseConsulForDiscovery("127.0.0.1", 8500, "JimuService", $"127.0.0.1:8001") // 使用 consul, "JimiService" 指定注册服务时，key 带上的前缀，相当于服务分组，$"127.0.0.1:8001" 指定服务宿主的访问地址              .UseJoseJwtForOAuth<Jimu.DotNettyAddress>(new Jimu.Server.OAuth.JwtAuthorizationOptions              {                  SecretKey = "123456",               }); // 使用 jwt 进行鉴权，这里只是验证 token,所以只需验证的密钥， 生产 token 在 Auth.Server 服务             using (var host = builder.Build())             {                 host.Run(); // 启动服务                 while (true)                 {                     Console.ReadKey();                 }             }         }     } }