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

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

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

写在前面

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

数据库生成

生成物理模型

  1. 首先用pdm打开我们设计的逻辑模型文件,后缀名是ldm的文件,如下图所示:

    1544535967072

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

    1544536138034

  3. 如下图所示选择号对应的数据库后,自定义物理模型的名称代码后点击确定即可生成物理模型。这里数据库类型有很多选择如:mysql,sqlserver,oracle等等,我们选择sqlserver2008,你可以随意从下拉框选择一个数据库进行生成(当然要跟你的数据库对应)!

    1544536437133

  4. 注意这里生成的物理模型默认是不会生成注释的如下图所示:

    1544537349509

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

    这时候你需要Tools->Execute Commands->Edit/Run Scripts (或者快捷键Ctrl+Shift+X)打开脚本执行的窗口,然后把下面的代码拷贝进行 run一下即可。

    '代码一:将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,(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,'PRECISION') 
                    AS ColumnLength,(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跟大伙一起讨论。共同进步!共勉!

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


在上文中,我介绍了事件驱动型架构的一种简单的实现,并演示了一个完整的事件派发、订阅和处理的流程。这种实现太简单了,百十行代码就展示了一个基本工作原理。然而,要将这样的解决方案运用到实际生产环境,还有很长的路要走。今天,我们就研究一下在事件处理器中,对象生命周期的管理问题。事实上,不仅仅是在事件处理器
上文已经介绍了Identity Service的实现过程。今天我们继续,实现一个简单的Weather API和一个基于Ocelot的API网关。 回顾 《Angular SPA基于Ocelot API网关与IdentityServer4的身份认证与授权(一)》 Weather API Weather
最近我为我自己的应用开发框架Apworks设计了一套案例应用程序,并以Apache 2.0开源,开源地址是:https://github.com/daxnet/apworks-examples,目的是为了让大家更为方便地学习和使用.NET Core、最新的前端开发框架Angular,以及Apwork
HAL(Hypertext Application Language,超文本应用语言)是一种RESTful API的数据格式风格,为RESTful API的设计提供了接口规范,同时也降低了客户端与服务端接口的耦合度。很多当今流行的RESTful API开发框架,包括Spring REST,也都默认支
在前面两篇文章中,我详细介绍了基本事件系统的实现,包括事件派发和订阅、通过事件处理器执行上下文来解决对象生命周期问题,以及一个基于RabbitMQ的事件总线的实现。接下来对于事件驱动型架构的讨论,就需要结合一个实际的架构案例来进行分析。在领域驱动设计的讨论范畴,CQRS架构本身就是事件驱动的,因此,
HAL,全称为Hypertext Application Language,它是一种简单的数据格式,它能以一种简单、统一的形式,在API中引入超链接特性,使得API的可发现性(discoverable)更强,并具有自描述的特点。使用了HAL的API会更容易地被第三方开源库所调用,并且使用起来也很方便
何时使用领域驱动设计?其实当你的应用程序架构设计是面向业务的时候,你已经开始使用领域驱动设计了。领域驱动设计既不是架构风格(Architecture Style),也不是架构模式(Architecture Pattern),它也不是一种软件开发方法论,所以,是否应该使用领域驱动设计,以及什么时候使用
《在ASP.NET Core中使用Apworks快速开发数据服务》一文中,我介绍了如何使用Apworks框架的数据服务来快速构建用于查询和管理数据模型的RESTful API,通过该文的介绍,你会看到,使用Apworks框架开发数据服务是何等简单快捷,提供的功能也非常多,比如对Hypermedia的
在上一讲中,我们已经完成了一个完整的案例,在这个案例中,我们可以通过Angular单页面应用(SPA)进行登录,然后通过后端的Ocelot API网关整合IdentityServer4完成身份认证。在本讲中,我们会讨论在当前这种架构的应用程序中,如何完成用户授权。 回顾 《Angular SPA基于
Keycloak是一个功能强大的开源身份和访问管理系统,提供了一整套解决方案,包括用户认证、单点登录(SSO)、身份联合、用户注册、用户管理、角色映射、多因素认证和访问控制等。它广泛应用于企业和云服务,可以简化和统一不同应用程序和服务的安全管理,支持自托管或云部署,适用于需要安全、灵活且易于扩展的用
3月7日,微软发布了Visual Studio 2017 RTM,与之一起发布的还有.NET Core Runtime 1.1.0以及.NET Core SDK 1.0.0,尽管这些并不是最新版,但也已经从preview版本升级到了正式版。所以,在安装Visual Studio 2017时如果启用了
在上文中,我介绍了如何在Ocelot中使用自定义的中间件来修改下游服务的response body。今天,我们再扩展一下设计,让我们自己设计的中间件变得更为通用,使其能够应用在不同的Route上。比如,我们可以设计一个通用的替换response body的中间件,然后将其应用在多个Route上。 O
不少关注我博客的朋友都知道我在2009年左右开发过一个名为Apworks的企业级应用程序开发框架,旨在为分布式企业系统软件开发提供面向领域驱动(DDD)的框架级别的解决方案,并对多种系统架构风格提供支持。这个框架的开发和维护我坚持了很久,一直到2015年,我都一直在不停地重构这个项目。目前这个项目在
好吧,这个题目我也想了很久,不知道如何用最简单的几个字来概括这篇文章,原本打算取名《Angular单页面应用基于Ocelot API网关与IdentityServer4ʺSP.NET Identity实现身份认证与授权》,然而如你所见,这样的名字实在是太长了。所以,我不得不缩写“单页面应用”几个字
在前面两篇文章中,我介绍了基于IdentityServer4的一个Identity Service的实现,并且实现了一个Weather API和基于Ocelot的API网关,然后实现了通过Ocelot API网关整合Identity Service做身份认证的API请求。今天,我们进入前端开发,设计
Ocelot是ASP.NET Core下的API网关的一种实现,在微服务架构领域发挥了非常重要的作用。本文不会从整个微服务架构的角度来介绍Ocelot,而是介绍一下最近在学习过程中遇到的一个问题,以及如何使用中间件(Middleware)来解决这样的问题。 问题描述 在上文中,我介绍了一种在Angu
在大数据处理和人工智能时代,数据工厂(Data Factory)无疑是一个非常重要的大数据处理平台。市面上也有成熟的相关产品,比如Azure Data Factory,不仅功能强大,而且依托微软的云计算平台Azure,为大数据处理提供了强大的计算能力,让大数据处理变得更为稳定高效。由于工作中我的项目
在上文中,我们讨论了事件处理器中对象生命周期的问题,在进入新的讨论之前,首先让我们总结一下,我们已经实现了哪些内容。下面的类图描述了我们已经实现的组件及其之间的关系,貌似系统已经变得越来越复杂了。其中绿色的部分就是上文中新实现的部分,包括一个简单的Event Store,一个事件处理器执行上下文的接
在之前《在ASP.NET Core中使用Apworks快速开发数据服务》一文的评论部分,.NET大神张善友为我提了个建议,可以使用Compile As a Service的Roslyn为语法解析提供支持。在此非常感激友哥给我的建议,也让我了解了一些Roslyn的知识。使用Roslyn的一个很大的好处
很长一段时间以来,我都在思考如何在ASP.NET Core的框架下,实现一套完整的事件驱动型架构。这个问题看上去有点大,其实主要目标是为了实现一个基于ASP.NET Core的微服务,它能够非常简单地订阅来自于某个渠道的事件消息,并对接收到的消息进行处理,于此同时,它还能够向该渠道发送事件消息,以便