【asp.net core 系列】- 11 Service层的实现样板

0.前言

在《asp.net core 系列》之实战系列中，咱们在以前的篇幅中对项目有了一个大概的认知，也搭建了一个基础的项目骨架。那么就让咱们继续完善这个骨架，让它更加丰满。这一篇，我将带领小伙伴们一块儿实现用户管理功能。

1. 数据表

通常状况下，咱们会把用户表和登陆信息表放在两个表里。为何会这样设计呢？出于如下几种考虑：

• 使功能分割，用户信息管理是用户管理，登陆是登陆

• 增长安全，下降无关信息的查询，例如访问登陆接口不会连带检索用户的普通讯息，当进行用户信息管理的时候，不会把登陆信息也带过来

等等

废话很少说，直接上代码：

namespace Data.Enums
{
    /// <summary>
    /// 登陆类型
    /// </summary>
    public enum LoginType : byte
    {
        /// token登陆
        Token,
        /// 用户名密码
        Password
    }
    /// <summary>
    /// 性别
    /// </summary>
    public enum SexEnum
    {
        /// 男
        Male,
        /// 女
        Female,
        /// 隐私
        None
    }
}

SysUserAuthEntity.cs

using Data.Enums;
using Data.Infrastructure;

namespace Data.Models
{
    public class SysUserAuthEntity : BaseEntity<int>
    {
        public string UserName { get; set; }
        public string Password { get; set; }

        public LoginType LoginType { get; set;}
    }
}

SysUserInfoEntity.cs

using System;
using Data.Enums;
using Data.Infrastructure;

namespace Data.Models
{

    public class SysUserInfoEntity : BaseEntity<int>
    {
        public string NickName { get; set; }
        public string ImageUrl { get; set; }
        public SexEnum Sex { get; set; }
        public DateTime? BirthDay { get; set; }

        public int SysUserAuthId { get; set; }

        public virtual SysUserAuthEntity SysUserAuth { get; set; }
    }
}

这里并无使用数据库Sql语句做为数据库描述，而是使用了Entity类做为描述，这是由于数据库到实体类之间仍是有一层转换，对于开发而言接触更多的是实体类，而不是数据表。

2. 生成 Repository相关

使用工具代码的方式有不少，我在这里推荐一种， Test项目中，添加一个测试类，具体代码以下：

using NUnit.Framework;
using System;
using System.Collections.Generic;
using System.Text;
using Utils.Develop;

namespace Test
{
    public class DevelopTest
    {
        [Test]
        public void TetDevelop()
        {
            var d = Develop.CurrentDirect;
            Console.WriteLine(d);
            Assert.IsTrue(d.Contains("template"));
            var entities = Develop.LoadEntities();
            foreach (var item in entities)
            {
                Console.WriteLine(item.FullName);
            }
        }
        [Test]
        public void TestCreateDevelop()
        {
            var entities = Develop.LoadEntities();
            foreach (var item in entities)
            {
                Develop.CreateRepositoryInterface(item);
                Develop.CreateRepositoryImplement(item);
                Develop.CreateEntityTypeConfig(item);
            }
            Assert.Pass();
        }
    }
}

具体的命令行执行比较麻烦，会执行全部的测试单元：

cd Test/
dotnet test

固然了，IDE支持单个测试单元的执行，具体操做这里就不作过多的介绍了。

3. Service 接口和实现类

一般Service接口会提供一个简单Crud的Service接口，而后其余业务接口继承该接口。这样能够减小代码的重复，由于重复的代码在开发过程当中是很是讨厌的一种状况，由于一旦一处发生变动，其余的也有可能发生变动。因此遇到重复代码通常都会进行必定程度的封装：

using System;
using System.Collections.Generic;
using System.Linq.Expressions;
using Data.Infrastructure;

namespace Service.Insfrastructure
{
    public interface BaseService<T>
    {
        T Get(object key);
        T Get(Expression<Func<T, bool>> predicate);

        PageModel<T> SearchPage(PageCondition<T> condition);

        void Delete(Expression<Func<T, bool>> predicate);

        void Update(T entity);

        List<T> Search(Expression<Func<T, bool>> predicate);

    }
}

暂时就提供了这些最多见的请求方法。

在Service.Implements项目中：

using System;
using System.Collections.Generic;
using System.Linq.Expressions;
using Data.Infrastructure;
using Domain.Insfrastructure;
using Service.Insfrastructure;

namespace Service.Implements.Insfrastructure
{
    public abstract class BaseServiceImpl<T> : BaseService<T>
    {
        private IRepository<T> LocalRepository { get; }

        protected BaseServiceImpl(IRepository<T> repository)
        {
            LocalRepository = repository;
        }


        public T Get(object key)
        {
            return LocalRepository.Get(key);
        }

        public T Get(Expression<Func<T, bool>> predicate)
        {
            return LocalRepository.Get(predicate);
        }

        public PageModel<T> SearchPage(PageCondition<T> condition)
        {
            return LocalRepository.Search(condition);
        }

        public void Delete(Expression<Func<T, bool>> predicate)
        {
            LocalRepository.Delete(predicate);
        }

        public void Update(T entity)
        {
            LocalRepository.Update(entity);
        }

        public List<T> Search(Expression<Func<T, bool>> predicate)
        {
            return LocalRepository.Search(predicate);
        }
    }
}

这个类设置为抽象类。

4. 用户管理的接口

先建立了两个简单的示范接口：

using Data.Models;
using Service.Insfrastructure;

namespace Service
{
    public interface ISysUserService : BaseService<SysUserInfoEntity>
    {
        void Register(SysUserAuthEntity auth, SysUserInfoEntity info);

        void ChangePassword(int userId, string oldPwd, string newPwd);
    }
}

实现类：

using System;
using Data.Models;
using Domain.Repository;
using Service.Implements.Insfrastructure;

namespace Service.Implements
{
    public class SysUserServiceImpl : BaseServiceImpl<SysUserInfoEntity>, ISysUserService
    {
        protected ISysUserAuthRepository AuthRepository { get; }
        protected ISysUserInfoRepository InfoRepository { get; }

        public SysUserServiceImpl(ISysUserAuthRepository authRepository, ISysUserInfoRepository infoRepository) : base(
            infoRepository)
        {
            AuthRepository = authRepository;
            InfoRepository = infoRepository;
        }

        public void Register(SysUserAuthEntity auth, SysUserInfoEntity info)
        {
            var authItem = AuthRepository.Get(p => p.LoginType == auth.LoginType && p.UserName == auth.UserName);
            if (authItem != null)
            {
                throw new Exception("用户信息已经存在");
            }

            info.SysUserAuth = auth;
            InfoRepository.Insert(info);
        }

        public void ChangePassword(int userId, string oldPwd, string newPwd)
        {
            var info = InfoRepository.Get(userId);
            var auth = AuthRepository.Get(info.SysUserAuthId);
            if (oldPwd == null || oldPwd != auth?.Password)
            {
                throw new Exception("原密码错误");
            }

            auth.Password = newPwd;

        }
    }
}

这里没对密码进行加密处理，直接使用明文。这在正式开发中是不容许的，密码不能使用明文保存。固然，这也不是最终代码，下一篇咱们将介绍一下.net core中常见的加密实现。

5. 总结

这一篇经过几个简单的示例为你们介绍了一下Service层的开发逻辑以及理念。下一篇将为你们介绍一下.net core中几种简单的加密实现。