第43章 菜单实体及其约束规则的定义实现

1 Core.Domain.Security.Menu

namespace Core.Domain.Security

{

    /// <summary>

    /// 【菜单--类】

    /// <remarks>

    /// 摘要：

    ///     通过该实体类及其属性成员，用于实现当前程序【Core】.【领域】.【安全】.【菜单】实体与“[ShopDemo].[Menu]”表之间的CURD的交互操作，并把这些数据存储到数据库设置实例中(内存)。

    /// </remarks>

    /// </summary>

    public class Menu : BaseEntity

    {

        #region 属性

        /// <summary>

        /// 【权限编号】

        /// <remarks>

        /// 摘要：

        ///     获取/设置权限实体1个指定实例的长整型编号值。

        /// </remarks>

        /// </summary>

        public long? PermissionId { get; set; }

        /// <summary>

        /// 【上级菜单编号】

        /// <remarks>

        /// 摘要：

        ///     获取/设置上级菜单实体1个指定实例上级菜单的长整型编号值(根级的父编号值为：0)。

        /// </remarks>

        /// </summary>

        public long ParentId { get; set; }

        /// <summary>

        /// 【名称】

        /// <remarks>

        /// 摘要：

        ///     获取/设置1个指定菜单的名称。

        /// </remarks>

        /// </summary>

        public string Name { get; set; }

        /// <summary>

        /// 【菜单级别】

        /// <remarks>

        /// 摘要：

        ///     获取/设置1个指定菜单的级别值(1~3)。

        /// </remarks>

        /// </summary>

        public int Level { get; set; }

        /// <summary>

        /// 【URL】

        /// <remarks>

        /// 摘要：

        ///     获取/设置1个指定菜单所要跳转的(相对)路由字符串。

        /// </remarks>

        /// </summary>

        public string Url { get; set; }

        /// <summary>

        /// 【图标】

        /// <remarks>

        /// 摘要：

        ///     获取/设置1个指定菜单所对应的图标。

        /// </remarks>

        /// </summary>

        public string Icon { get; set; }

        /// <summary>

        /// 【图标颜色】

        /// <remarks>

        /// 摘要：

        ///     获取/设置1个指定菜单所对应图标的颜色。

        /// </remarks>

        /// </summary>

        public string IconColor { get; set; }

        #endregion

        #region 属性--映射和级联构建

        /// <summary>

        /// 【单个权限】

        /// <remarks>

        /// 摘要：

        ///     获取/设置1个指定菜单实例所对应的1个权限实例。

        /// 说明：

        ///     构建权限与菜单实体及其表之间的1:n映射关系，但在实现和逻辑定义实现上以用户为主。

        /// </remarks>

        /// </summary>

        public virtual Permission PermissionSingle { get; set; }

        #endregion

    }

}

2 重构Core.Domain.Security.Permission

 /// <summary>

        /// 【菜单集】

        /// <remarks>

        /// 摘要：

        ///     获取/设置1个指定权限实例所对应的所有菜单映射实例。

        /// 说明：

        ///     构建权限与菜单实体及其表之间的1:n映射关系，但在实现和逻辑定义实现上二者是平等关系。

        /// </remarks>

        /// </summary>

        public virtual ICollection<Menu> MenuCollection { get; set; }

3 Data.Mapping.Security.MenuBuilder

//Nuget

//Nuget--Microsoft.EntityFrameworkCore.SqlServer

using Microsoft.EntityFrameworkCore;

using Microsoft.EntityFrameworkCore.Metadata.Builders;

//项目

using Core.Domain.Security;

namespace Data.Mapping.Security

{

    /// <summary>

    /// 【菜单生成器--类】

    /// <remarks>

    /// </remarks>

    /// </summary>

    public class MenuBuilder : IEntityTypeConfiguration<Menu>

    {

        #region 方法--IEntityTypeConfiguration<>

        ///<param name="builder">实体类型生成器实例，用于把当前程序中指定实体和属性所定义的约束规则，映射到数据库指定表及其字段上。</param>

        /// <summary>

        /// 【配置】

        /// <remarks>

        /// 摘要：

        ///     该方法通过对“EntityFrameworkCore”中间件“IEntityTypeConfiguration<TEntity/>”泛型接口的“Configure”方法的定义，以实现把菜单实体类及其属性成员相关约束规则及其级联关系定义，映射到菜单表及其的相应字段上。

        /// </remarks>

        /// </summary>

        public void Configure(EntityTypeBuilder<Menu> builder)

        {

            //由于“EntityTypeBuilder<Menu>”的参数已经泛型实例化，因此builder后不能再定义为：“builder.Entity<Menu>().HasKey(menu => menu.Id);”。

            //权限表及其字段约束规则，映射定义。

            builder.HasKey(menu => menu.Id);

            builder.Property(menu => menu.Name).IsRequired().HasMaxLength(255);

            builder.Property(menu => menu.Url).HasMaxLength(255);

            builder.Property(menu => menu.Icon).HasMaxLength(255);

            builder.Property(menu => menu.IconColor).HasMaxLength(255);

        }

        #endregion

    }

}

对以上功能更为具体实现和注释见：230211_037shopDemo(菜单实体及其约束规则的定义实现)。