abp(net core)+easyui+efcore仓储系统——领域层创建实体(三)

2023-08-15 19:58:22

在上二篇文章中我们简单介绍了一下ABP.TPLMS系统的概况，已经对ABP的体系结构以及项目结构有了一个初步的了解。在这一篇文章中我们主要和领域层打交道，主要是创建实体与进行迁移。接下来我们开始创建Module实体。

一、创建Module实体

实体是DDD（领域驱动设计）的核心概念之一。Eirc Evans是这样描述的实体的：“它根本上不是通过属性定义的，而是通过一系列连续性和标识定义的”。因此，实体都有Id属性并且都存储到数据库中。一个实体一般会映射到数据库的一张表。现在我们来完成以下任务：在领域层创建一个Entitys文件夹，并在这个文件夹中创建Module实体类。

1.
在Visual Studio 2017的“解决方案资源管理器”中，右键单击“ABP.TPLMS.Core”项目。选择“添加” > “新建文件夹”。如下图。

2．将文件夹命名为“Entitys”。

3．右键单击“Entitys”文件夹，然后选择“添加” > “类”。
将类命名为 Module，然后选择“添加”。如下图。

4.ABP中所有的实体类都继承自Entity，而Entity实现了IEntity接口；而IEntity接口是一个泛型接口，通过泛型指定主键Id类型，默认的Entity的主键类型是int类型。如下图。

5.创建Module类，肯定需要保存创建时间，可以通过实现审计模块中的IHasCreationTime来实现这种通用功能。如下图。

6. abp中实体是派生于Entity类，先看一下我们在Core层新建的Module类。代码如下：

using Abp.Domain.Entities;

using Abp.Domain.Entities.Auditing;

using Abp.Timing;

using System;

using System.Collections.Generic;

using System.ComponentModel.DataAnnotations;

using System.Text; 

namespace ABP.TPLMS.Entitys

{

    public class Module:Entity, IHasCreationTime

    {

        public const int MaxLength = ;

        public Module()

        {

            this.DisplayName = string.Empty;

            this.Name = string.Empty;

            this.Url = string.Empty;

            this.HotKey = string.Empty;

            this.ParentId = ;

            this.IconName = string.Empty;

            this.Status = ;

            this.ParentName = string.Empty;

            this.RequiredPermissionName = string.Empty;

            this.RequiresAuthentication = false;

            this.SortNo = ;         

            CreationTime = Clock.Now;

        }    

        [Required]

        [StringLength(MaxLength)]

        public string DisplayName { get; set; }

        [Required]

        [StringLength(MaxLength)]

        public string Name { get; set; } 

        [Required]

        [StringLength(MaxLength)]

        public string Url { get; set; }

        [StringLength(MaxLength)]

        public string HotKey { get; set; }

        public int ParentId { get; set; }

        public bool RequiresAuthentication { get; set; }

        public bool IsAutoExpand { get; set; } 

        [StringLength(MaxLength)]

        public string IconName { get; set; }

        public int Status { get; set; } 

        [Required]

        [StringLength(MaxLength)]

        public string ParentName { get; set; }

        [StringLength(MaxLength)]

        public string RequiredPermissionName { get; set; }

        public int SortNo { get; set; }

        public DateTime CreationTime { get; set; }

    }

}

在上面的Module实体类中的一些属性上我们定义了[Required]、[MaxLength]等特性用来进行输入校验的。

上面的Module实体类，没有添加Id属性，为什么呢？因为Module继承自Entity类，Entity类已经定义Id，它是该Entity类的主键。因此，所有继承Entity类的实体类的主键名都是Id。

Id（主键）的类型是可以更改的，默认是int(int32)。如果你想将Id定义为其他类型，可以在<>内写,比如Guid,long也是可以的。

Entity类重写了等号运算符（==），可以轻松地检查两个实体是否相同了（实体的Id相同则认为它们相同）。它也定义了IsTransient方法来检测它是否有Id。

IHasCreationTime接口使用一个通用的属性来描述一个实体的“创建时间”。当实现了该接口的实体类插入到数据库中时，ABP会自动地将当前的时间设置给CreationTime。

7.定义好实体之后，我们就要去DbContext中定义实体对应的DbSet，以应用Code First 数据迁移。找到我们的基础服务层，即以EntityFrameworkCore结尾的项目中，找到DbContext类，如下图，添加以下代码。

using Microsoft.EntityFrameworkCore;

using Abp.Zero.EntityFrameworkCore;

using ABP.TPLMS.Authorization.Roles;

using ABP.TPLMS.Authorization.Users;

using ABP.TPLMS.MultiTenancy;

using ABP.TPLMS.Entitys;

namespace ABP.TPLMS.EntityFrameworkCore

{

    public class TPLMSDbContext : AbpZeroDbContext<Tenant, Role, User, TPLMSDbContext>

    {

        /* Define a DbSet for each entity of the application */      

        public TPLMSDbContext(DbContextOptions<TPLMSDbContext> options)

            : base(options)

        {

        }

        public DbSet<Module> Modules { get; set; }

    }

}