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();
                }
            }
        }
    }
}

Flamesky