.NET Core实战项目之CMS 第十一章 开发篇-数据库生成及实体代码生成器开发

时间  2019-11-08
标签 core 实战 项目 cms 第十 一章 开发 数据库 生成 实体 代码 成器 栏目 CMS 繁體版
原文   原文链接

上篇给你们从零开始搭建了一个咱们的ASP.NET Core CMS系统的开发框架，具体为何那样设计我也已经在第十篇文章中进行了说明。不过文章发布后不少人都说了这样的分层不是很合理，什么数据库实体应该跟仓储放在一块儿造成领域对象，什么ViewModel应该放在应用层结构仓储层与UI层。其实我想说的是，这样都没问题，看你本身的理解了！我上篇文章已经说了，若是你愿意，彻底能够把全部的层融合在一块儿，随意合并分离这个依你我的喜爱。
我也是本着简单原则以及合适原则的思想来进行那样的分层结构，以为这样层次更分明些。还有虽然如今DDD的思想很流行，可是实现起来确很复杂，小项目就别那样折腾了。若是你有不一样的意见，欢迎加群讨论。什么？你问我群号？本身找去，我才不会告诉你！html

本文已收录至《.NET Core实战项目之CMS 第一章 入门篇-开篇及整体规划》
做者：依乐祝
原文地址：https://www.cnblogs.com/yilezhu/p/10112406.htmlmysql

写在前面

今天咱们就进入.NET Core实战项目之CMS的开发篇了，在开始以前呢咱们首先须要把咱们前面设计的逻辑模型转换成对应的物理模型，再根据咱们物理模型生成相应的数据库脚本，接着咱们就新建数据库，而后执行下咱们生成的脚本便可。固然这么多表若是一个一个的写对应的数据库实体模型，一个一个的写仓储层代码以及服务层代码，感受就是在搬砖啊，有木有，因此固然得本身实现个代码生成器来自动生成这些代码了！下面咱们一步步来先生成下数据库而后再打造一个实体模型的代码生成器吧！git

数据库生成

生成物理模型

  1. 首先用pdm打开咱们设计的逻辑模型文件，后缀名是ldm的文件，以下图所示：程序员

    1544535967072

  2. 依次点击“Tools”-》"Generate Physical Data Model",以下图所示。或者直接使用快捷键Ctrl+Shift+P 打开物理模型生成选项对话框。github

    1544536138034

  3. 以下图所示选择号对应的数据库后，自定义物理模型的名称代码后点击肯定便可生成物理模型。这里数据库类型有不少选择如：mysql,sqlserver,oracle等等，咱们选择sqlserver2008,你能够随意从下拉框选择一个数据库进行生成（固然要跟你的数据库对应）！sql

    1544536437133

  4. 注意这里生成的物理模型默认是不会生成注释的以下图所示：数据库

    1544537349509

    怎么办呢？如何才能讲Name 列的内容拷贝到Comment这个里面呢？由于这个Commment里面的内容才会真正的转换到数据库字段的注释。c#

    这时候你须要Tools->Execute Commands->Edit/Run Scripts （或者快捷键Ctrl+Shift+X）打开脚本执行的窗口，而后把下面的代码拷贝进行 run一下便可。oracle

    '代码一:将Name中的字符COPY至Comment中


Option   Explicit 
ValidationMode   =   True 
InteractiveMode   =   im_Batch

Dim   mdl   '   the   current   model

'   get   the   current   active   model 
Set   mdl   =   ActiveModel 
If   (mdl   Is   Nothing)   Then 
      MsgBox   "There   is   no   current   Model " 
ElseIf   Not   mdl.IsKindOf(PdPDM.cls_Model)   Then 
      MsgBox   "The   current   model   is   not   an   Physical   Data   model. " 
Else 
      ProcessFolder   mdl 
End   If

'   This   routine   copy   name   into   comment   for   each   table,   each   column   and   each   view 
'   of   the   current   folder 
Private   sub   ProcessFolder(folder) 
      Dim   Tab   'running     table 
      for   each   Tab   in   folder.tables 
            if   not   tab.isShortcut   then 
                  tab.comment   =   tab.name 
                  Dim   col   '   running   column 
                  for   each   col   in   tab.columns 
                        col.comment=   col.name 
                  next 
            end   if 
      next

      Dim   view   'running   view 
      for   each   view   in   folder.Views 
            if   not   view.isShortcut   then 
                  view.comment   =   view.name 
            end   if 
      next

      '   go   into   the   sub-packages 
      Dim   f   '   running   folder 
      For   Each   f   In   folder.Packages 
            if   not   f.IsShortcut   then 
                  ProcessFolder   f 
            end   if 
      Next 
end   sub

    1544537692272

    这里脚本执行的很快，你也能够把脚本保存起来下次再用，执行后的效果以下所示：框架

    1544537771197

    咱们的Comment这一行的内容已经跟Name同样了！

数据库脚本生成

  1. 首先打开咱们生成的物理模型，扩展名为pdm的文件，以下图所示，乍一看跟逻辑模型差很少，实际上仍是有区别的！

    1544538222229

  2. 而后依次以下图所示选择“Database”->"Generate Database" 或者快捷键Ctrl+G打开数据库生成选项对话框

    1544538320805

  3. 以下图所示设置一下生成的数据库脚本的路径以及脚本名称便可生成数据库脚本文件，以下图所示：

    1544539197457

  4. 到咱们上面设置的文件夹里便可查看到咱们生成的数据库脚本，以下图所示：

    1544539359326

数据库生成

  1. 打开咱们的数据库，并新建一个名为CzarCms的新的数据库，以下图所示：

    1544539477339

  2. 选择咱们新建的数据库，而后按照以下图所示的方式打开咱们刚才生成的数据库脚本

    1544539621124

  3. 以下图所示确认一下目前选择的是你刚新建的数据库，而后点击执行，执行下脚本

    1544539734388

  4. 不出之外的话会出现以下图所示的“命令已成功完成”的消息，这表示脚本执行成功了，而后刷新下咱们刚才的数据库，能够看到咱们的表已经生成成功了！

    1544539898998

  5. 这里你能够检查下，看看生成的数据库表有没有问题，若是有问题的话，从新走一遍流程生成脚本而后执行下就好了，不过须要注意的是，若是你数据库中有数据就要小心了，从新生成的脚本会drop掉你的表从新建立，因此若是是个别字段出问题的话就逻辑模型以及物理模型修改后，手动在数据库中修改便可！

  6. 这里我给每一个表的主键设计了自增，给isdelete等等设置了默认的0，以及addtime设置了getdate()等等。

实体模型生成器编写

好了，上面我已经带着你一步一步的演示了数据库的建立过程，下面我就带着你实现一个简单的POCO实体对象的代码生成器吧！什么？市面上不是有不少代码生成器吗？靠，我就是要带着你本身实现一个，咋滴？是用别人的爽，仍是用本身实现的爽呢？本身琢磨吧！

思考

你们先脑补一下，若是是你想根据数据库实现一个代码生成器你的思路是怎样的呢？是否是首先得获取下数据库里面的全部的表，而后获取这些表对应的列以及列的类型，是否为空等等信息。而后再建一个模板，循环这些表的信息来根据模板建立对应的文件呢。
至于模板文件可能你会想到T4或者CodeSmish模板等等，可这些都太复杂了，复杂的语法以及灵活性的问题我这里选择另外一个文本文件的形式来进行代码的生成。

这个代码生成器的灵感以及部分代码来自于Zxw.Framework.NetCore，这个框架的github地址是：https://github.com/VictorTzeng/Zxw.Framework.NetCore/tree/master/Zxw.Framework.NetCore 有兴趣的小伙伴能够看下。

下面就让咱们简单实现下咱们本身的实体模型代码生成器吧.

实体代码生成器

  1. 首先咱们建立一个Option对象来接收咱们所须要的参数，好比说：数据库类型，数据库链接字符串，做者，实体模型的命名空间等等，以下所示：

    /// <summary>
    /// yilezhu
    /// 2018.12.12
    /// 代码生成选项
    /// </summary>
    public class CodeGenerateOption
    {
        /// <summary>
        /// 数据库链接字符串
        /// </summary>
        public string ConnectionString { get; set; }
        /// <summary>
        /// 数据库类型
        /// </summary>
        public string DbType  { get; set; }
        /// <summary>
        /// 做者
        /// </summary>
        public string Author { get; set; }

        /// <summary>
        /// 代码生成时间
        /// </summary>
        public string GeneratorTime { get; set; } = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");

        /// <summary>
        /// 输出路径
        /// </summary>
        public string OutputPath { get; set; }

        /// <summary>
        /// 实体命名空间
        /// </summary>
        public string ModelsNamespace { get; set; }
    }

  2. 从数据库里面获取全部表的脚本,这里我只是简单的实现了下SqlServer的代码，后续我会对这块进行提取封装，并支持MySql,Oracle,PSQL等等：

    //TODO 从数据库获取表列表以及生成实体对象
            if (_options.DbType != DatabaseType.SqlServer.ToString())
                throw new ArgumentNullException("这是个人错，目前只支持MSSQL数据库的代码生成！后续更新MySQL");
            DatabaseType dbType = DatabaseType.SqlServer;
            string strGetAllTables = @"SELECT DISTINCT d.name as TableName, f.value as TableComment
FROM      sys.syscolumns AS a LEFT OUTER JOIN
                sys.systypes AS b ON a.xusertype = b.xusertype INNER JOIN
                sys.sysobjects AS d ON a.id = d.id AND d.xtype = 'U' AND d.name <> 'dtproperties' LEFT OUTER JOIN
                sys.syscomments AS e ON a.cdefault = e.id LEFT OUTER JOIN
                sys.extended_properties AS g ON a.id = g.major_id AND a.colid = g.minor_id LEFT OUTER JOIN
                sys.extended_properties AS f ON d.id = f.major_id AND f.minor_id = 0";
            List<DbTable> tables = null;
            using (var conn = new SqlConnection(_options.ConnectionString))
            {
                tables = conn.Query<DbTable>(strGetAllTables).ToList();

  3. 遍历每一个表而后获取每一个表对应的列（也是只实现的SqlServer的代码）

    tables.ForEach(item =>
                {
                    string strGetTableColumns = @"SELECT   a.name AS ColName, CONVERT(bit, (CASE WHEN COLUMNPROPERTY(a.id, a.name, 'IsIdentity') 
                = 1 THEN 1 ELSE 0 END)) AS IsIdentity, CONVERT(bit, (CASE WHEN
                    (SELECT   COUNT(*)
                     FROM      sysobjects
                     WHERE   (name IN
                                         (SELECT   name
                                          FROM      sysindexes
                                          WHERE   (id = a.id) AND (indid IN
                                                              (SELECT   indid
                                                               FROM      sysindexkeys
                                                               WHERE   (id = a.id) AND (colid IN
                                                                                   (SELECT   colid
                                                                                    FROM      syscolumns
                                                                                    WHERE   (id = a.id) AND (name = a.name))))))) AND (xtype = 'PK')) 
                > 0 THEN 1 ELSE 0 END)) AS IsPrimaryKey, b.name AS ColumnType, COLUMNPROPERTY(a.id, a.name, 'PRECISION') 
                AS ColumnLength, CONVERT(bit, (CASE WHEN a.isnullable = 1 THEN 1 ELSE 0 END)) AS IsNullable, ISNULL(e.text, '') 
                AS DefaultValue, ISNULL(g.value, ' ') AS Comment
FROM      sys.syscolumns AS a LEFT OUTER JOIN
                sys.systypes AS b ON a.xtype = b.xusertype INNER JOIN
                sys.sysobjects AS d ON a.id = d.id AND d.xtype = 'U' AND d.name <> 'dtproperties' LEFT OUTER JOIN
                sys.syscomments AS e ON a.cdefault = e.id LEFT OUTER JOIN
                sys.extended_properties AS g ON a.id = g.major_id AND a.colid = g.minor_id LEFT OUTER JOIN
                sys.extended_properties AS f ON d.id = f.class AND f.minor_id = 0
WHERE   (b.name IS NOT NULL) AND (d.name = @TableName)
ORDER BY a.id, a.colorder";
                    item.Columns = conn.Query<DbTableColumn>(strGetTableColumns, new
                    {
                        TableName = item.TableName
                    }).ToList();

  4. 接下来就是对数据库获取的列进行一个转换，根据数据库字段类型转换成对应的C#类型了

    item.Columns.ForEach(x =>
                    {
                        var csharpType = DbColumnTypeCollection.DbColumnDataTypes.FirstOrDefault(t =>
                            t.DatabaseType == dbType && t.ColumnTypes.Split(',').Any(p =>
                                p.Trim().Equals(x.ColumnType, StringComparison.OrdinalIgnoreCase)))?.CSharpType;
                        if (string.IsNullOrEmpty(csharpType))
                        {
                            throw new SqlTypeException($"未从字典中找到\"{x.ColumnType}\"对应的C#数据类型，请更新DbColumnTypeCollection类型映射字典。");
                        }

                        x.CSharpType = csharpType;
                    });

  5. 既然全部的表以及表对应的列咱们都拿到了，那么咱们就能够进行代码的生成了，固然在生成以前还得建立咱们的模板文件：

    // 本代码由代码生成器生成请勿随意改动
// 生成时间  {GeneratorTime}
using System;

namespace {ModelsNamespace}
{
 /// <summary>
 /// {Author}
 /// {GeneratorTime}
 /// {Comment}
 /// </summary>
 public class {ModelName}
 {
     {ModelProperties}
 }
}

    看到没有，很简单的POCO对象的样子，接下来就是生成对应的模板了，具体怎么生成呢？思考下：是否是首先读取模板文件到一个string里面，而后就是简单的replace了！很简单吧，具体的代码我都上传到了Github上，文章末尾我会给出地址。另外为了你们引用的方便我已经把这个Czar.Cms.Core项目制做成了Nuget包，你们只须要搜索这个包引用下就能够用了！什么？Nuget包怎么引用啊？骚年你能够上天了~~~~~

测试实体代码生成器

  1. Czar.Cms.Test 这个项目添加Nuget包引用，引用后的Nuget以下所示：

    1544663123867

  2. 接下来就是新建一个测试类，而后建立一个依赖注入容器，并把咱们须要的Option传递进去，以下所示：

    /// <summary>
        /// 构造依赖注入容器，而后传入参数
        /// </summary>
        /// <returns></returns>
        public IServiceProvider BuildServiceForSqlServer()
        {
            var services = new ServiceCollection();

            services.Configure<CodeGenerateOption>(options =>
            {
                options.ConnectionString = "Data Source=.;Initial Catalog=CzarCms;User ID=sa;Password=1;Persist Security Info=True;Max Pool Size=50;Min Pool Size=0;Connection Lifetime=300;";//这个必须
                options.DbType = DatabaseType.SqlServer.ToString();//数据库类型是SqlServer,其余数据类型参照枚举DatabaseType//这个也必须
                options.Author = "yilezhu";//做者名称，随你，不写为空
                options.OutputPath = @"E:\workspace\vs2017\Czar.Cms\src\Czar.Cms.Models";//实体模型输出路径，为空则默认为当前程序运行的路径
                options.ModelsNamespace = "Czar.Cms.Models";//实体命名空间
            });
            services.AddSingleton<CodeGenerator>();//注入Model代码生成器
            return services.BuildServiceProvider(); //构建服务提供程序
        }

  3. 接着就是写咱们的测试方法了，代码以下：

    [Fact]
        public void GeneratorModelForSqlServer()
        {
            var serviceProvider= BuildServiceForSqlServer();
            var codeGenerator = serviceProvider.GetRequiredService<CodeGenerator>();
            codeGenerator.GenerateModelCodesFromDatabase();
            Assert.Equal(0,0);

        }

  4. 运行一下咱们的Live Unit Testing 而后看一下咱们的Czar.Cms.Models下面已经生成了对应的实体文件，以下图所示：

    1544663523474

  5. 随便打开一个看小效果以下：我标注的你猜猜看都是对应的哪一个Options

    1544663584296

开源地址

这个系列教程的源码我会开放在GitHub以及码云上，有兴趣的朋友能够下载查看！以为不错的欢迎Star
GitHub：https://github.com/yilezhu/Czar.Cms
码云：https://gitee.com/yilezhu/Czar.Cms
若是你以为这个系列对您有所帮助的话，欢迎以各类方式进行赞助，固然给个Star支持下也是能够滴！另一种最简单粗暴的方式就是下面这种直接关注咱们的公众号了：

第一时间收到更新推送。

总结

这篇文章咱们一步一步的生成了咱们的数据库，而后手把手带着你实现了咱们本身的实体模型代码生成器来简化咱们的开发过程。接下来咱们就开始实现仓储层应用层的代码了，同时咱们会提取通用部分的代码来进行模板代码生成来简化咱们的工做！俗话说的好，不会偷懒的程序员不是一个好爸爸，好丈夫，好儿子，减小代码的时间多抽点时间陪陪家人吧！若是你有其余想法能够在下方留言，或者加群637326624跟大伙一块儿讨论。共同进步！共勉！

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程