【asp.net core 系列】- 11 Service層的實(shí)現(xiàn)樣板

0.前言

在《asp.net core 系列》之實(shí)戰(zhàn)系列中,我們?cè)谥暗钠袑?duì)項(xiàng)目有了一個(gè)大概的認(rèn)知,也搭建了一個(gè)基礎(chǔ)的項(xiàng)目骨架。那么就讓我們繼續(xù)完善這個(gè)骨架,讓它更加豐滿。這一篇,我將帶領(lǐng)小伙伴們一起實(shí)現(xiàn)用戶管理功能。

1. 數(shù)據(jù)表

一般情況下,我們會(huì)把用戶表和登錄信息表放在兩個(gè)表里。為什么會(huì)這樣設(shè)計(jì)呢?出于以下幾種考慮:

  • 使功能分割,用戶信息管理是用戶管理,登錄是登錄
  • 增加安全,降低無關(guān)信息的查詢,例如訪問登錄接口不會(huì)連帶檢索用戶的普通信息,當(dāng)進(jìn)行用戶信息管理的時(shí)候,不會(huì)把登錄信息也帶過來

等等

廢話不多說,直接上代碼:

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

這里并沒有使用數(shù)據(jù)庫(kù)Sql語句作為數(shù)據(jù)庫(kù)描述,而是使用了Entity類作為描述,這是因?yàn)閿?shù)據(jù)庫(kù)到實(shí)體類之間還是有一層轉(zhuǎn)換,對(duì)于開發(fā)而言接觸更多的是實(shí)體類,而不是數(shù)據(jù)表。

2. 生成 Repository相關(guān)

使用工具代碼的方式有很多,我在這里推薦一種, Test項(xiàng)目中,添加一個(gè)測(cè)試類,具體代碼如下:

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

具體的命令行執(zhí)行比較麻煩,會(huì)執(zhí)行所有的測(cè)試單元:

cd Test/
dotnet test

當(dāng)然了,IDE支持單個(gè)測(cè)試單元的執(zhí)行,具體操作這里就不做過多的介紹了。

3. Service 接口和實(shí)現(xiàn)類

通常Service接口會(huì)提供一個(gè)簡(jiǎn)單Crud的Service接口,然后其他業(yè)務(wù)接口繼承該接口。這樣可以減少代碼的重復(fù),因?yàn)橹貜?fù)的代碼在開發(fā)過程中是非常討厭的一種情況,因?yàn)橐坏┮惶幇l(fā)生變更,其他的也有可能發(fā)生變更。所以遇到重復(fù)代碼一般都會(huì)進(jìn)行一定程度的封裝:

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

    }
}

暫時(shí)就提供了這些最常見的請(qǐng)求方法。

在Service.Implements項(xiàng)目中:

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

這個(gè)類設(shè)置為抽象類。

4. 用戶管理的接口

先創(chuàng)建了兩個(gè)簡(jiǎn)單的示范接口:

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

實(shí)現(xiàn)類:

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("用戶信息已經(jīng)存在");
            }

            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("原密碼錯(cuò)誤");
            }

            auth.Password = newPwd;

        }
    }
}

這里沒對(duì)密碼進(jìn)行加密處理,直接使用明文。這在正式開發(fā)中是不允許的,密碼不能使用明文保存。當(dāng)然,這也不是最終代碼,下一篇我們將介紹一下.net core中常見的加密實(shí)現(xiàn)。

5. 總結(jié)

這一篇通過幾個(gè)簡(jiǎn)單的示例為大家介紹了一下Service層的開發(fā)邏輯以及理念。下一篇將為大家介紹一下.net core中幾種簡(jiǎn)單的加密實(shí)現(xiàn)。

更多內(nèi)容煩請(qǐng)關(guān)注我的博客《高先生小屋》

file
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

友情鏈接更多精彩內(nèi)容