技术思绪摘录旅行笔记
Microsoft.EntityFrameworkCore是一个非常不错的设计,当一套系统里面出现太多的SQL,其实已经不合理了,所以EF让开发者不再接触SQL,而是直接以对象形式操作数据库,EF来负责Sql代码生成和执行,通常在开发中,有根据数据表结构来生成实体的,也有根据实体生成数据库的,就是所谓的DbFirst和CodeFirst,这篇文章主要说一下CodeFirst的应用,用的是MySql数据库。

前言:

CodeFirst运用的场景比较少,不代表CodeFirst不好,也不能和DbFirst去作比较,本来就是两个东西。

吐槽:

MySql.Data.EntityFrameworkCore 作为Oracle官方维护的组件,居然对EF很多API不支持或者无效,最后放弃使用,改用Pomelo.EntityFrameworkCore.MySql,这是第三方维护的,支持比官方好得多啊。


搭建开始:

1、首先我们需要创建一个.NetCore 3.1的控制台项目,就叫CodeFirstDemo,并且引入以下组件。

    -Microsoft.EntityFrameworkCore.Tools 3.1.5

    -Pomelo.EntityFrameworkCore.MySql 3.1.1 

2、确定好链接字符串,注意:CodeFirst的时候,可以不用创建数据库,程序会自动创建,我们只需要保证能链接到数据库服务就行。

 server=127.0.0.1;port=3306; user id=root; password=123456;database=test;

3、创建一个Models文件夹,编写我们自己的实体类 UserInfo.cs

 using System.ComponentModel.DataAnnotations;

namespace CodeFirstDemo.Models
{
    /// <summary>
    /// 用户表
    /// </summary>
    public class UserInfo
    {
        /// <summary>
        ///用户ID
        /// </summary>
        [Key]
        public string UserId { get; set; }

        /// <summary>
        ///用户名
        /// </summary>
        public string UserName { get; set; }

        /// <summary>
        ///用户年龄
        /// </summary>
        public int Age { get; set; }
    }
}

4、编写我们项目的Context文件,根目录创建也行,单独建个文件夹存放也行,我这里直接放根目录, 取名为TestContext.cs

using CodeFirstDemo.Models;
using Microsoft.EntityFrameworkCore;

namespace CodeFirstDemo
{
    public class TestContext : DbContext
    {
        /// <summary>
        ///配置
        /// </summary>
        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            optionsBuilder.UseMySql("server=127.0.0.1;port=3306; user id=root; password=123456;database=test;");
        }

        /// <summary>
        ///用户表对象
        /// </summary>
        public DbSet<UserInfo> UserInfo { get; set; }

        /// <summary>
        ///实体对象的配置
        /// </summary>
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<UserInfo>(entity =>
            {
                entity.HasComment("用户表");
                entity.Property(t => t.UserId).HasComment("用户ID");
                entity.Property(t => t.Age).HasComment("用户年龄");
                entity.Property(t => t.UserName).HasComment("用户名");
            });
        }
    }
}

注意看啊,表的备注和字段的备注是单独去设置的,而不是直接读取<summary>里面的内容,相当于注释咱们得再写一次,三个字段还好,100张表,每张表20个字段,可想这工作量,后面再说我们怎么解决的。

5、这个时候,我们可以将我们代码同步到数据库了。打开程序包管理控制台。

image.png

image.png

6、我们将在这里执行EF的数据迁移命令。先介绍一下有哪些命令。

>get-help entityframework

image.png

可以看到有这么几个命令,不多,他们的作用也有介绍,我们只需要会用其中几个就行。常用的如下:

>Add-Migration [name]      //添加迁移文件/初始化
>Update-Database           //执行迁移 没有数据库会自动创建
>Drop-Database                //删库
>get-help entityframework    //获取帮助
>Script-Migration            //生成sql脚本,来手动迁移

7、我们添加迁移文件,这时候不会创建数据库,只是创建一个迁移文件。

>Add-Migration init      //添加迁移文件/初始化建库

image.png

看到自动生成了Migrations文件夹,并在其中生成了几个文件,并且打开了其中的xxxxxxx_init.cs这个文件。

我们发现这个类其实是时间_[name]来命名的,并且其中记录了数据库这次的变化。

8、执行迁移,更新到数据库。

这里会自动为我们创建数据库。如果你自己手动创建了,可能会报错,因为里面缺了他自己的一张迁移记录表。所以如果要自己创建数据库,还得准备他迁移所需的表,索性就让他自动创建库了。

>Update-Database           //执行迁移 没有数据库会自动创建

image.png

这边看到已经执行完成,这次项目没有任何变化,变化在数据库那边,我们打开数据库软件,去看看。

image.png

我们发现,多了个名为Test的数据库,并且里面有两张表,一个UserInfo是我们自己创建的,还有就是他自己的迁移历史表。

到这里一个完成的CodeFirst已经完成了。

9、如果我们改了数据库实体,增加了一个字段或者修改了字段,咋搞?

我们还是执行这两句命令就行了,只是添加迁移文件的时候,名称不能和之前重复即可。

>Add-Migration updateuserinfo      //添加迁移文件
>Update-Database           //执行迁移

10、如果你错误太多,或者迁移文件太多了,管理复杂,你可以用删除库,删除Migrations文件夹,再次初始化即可。

>Drop-Database                //删库
>Add-Migration init      //添加迁移文件
>Update-Database           //执行迁移

11、回到开头的问题,当我有100张表,每张表20个字段的时候,备注应该怎么加,总不能挨个字段手写吧。

我的解决方案如下:

根据项目的xml文件,来解析生成这段代码,让我们免于手写浪费时间,前提是你的summary注释写的有用。

12、生成xml

项目名称上右键-->属性-->生成-->XML文档文件,我把他放在了App_Data文件夹下,如果不改,则会生成到根目录下。

image.png

编译一下,看看是否生成xml文件。

image.png

没有问题,我们打开这个xml文件,看看里面什么结构。

image.png

我们看下xml结构:

members-->member[name='T:CodeFirstDemo.Models.UserInfo']  这个节点下是用户表类注释。name属性是T开头的。
members-->member[name='P:CodeFirstDemo.TestContext.UserInfo']  这个节点下是我们Context的属性备注。name是P开头的。

这两个地方都可以得到表的名称或者备注。

再看字段的备注从哪里来。

members-->member[name='P:CodeFirstDemo.Models.UserInfo.UserId']  这个节点下是我们UserInfo类的属性备注。name是P开头的。

所以说,xml文件中有我们所需的所有信息,包括字段名称。我们来写个方法读取xml并生成下面这段代码。

modelBuilder.Entity<UserInfo>(entity =>
{
    entity.HasComment("用户表");
    entity.Property(t => t.UserId).HasComment("用户ID");
    entity.Property(t => t.Age).HasComment("用户年龄");
    entity.Property(t => t.UserName).HasComment("用户名");
});

代码如下:我是写了个控制台程序专门来做这个事情,所以我把xml文件拷贝过去,再读取。

string xmlPath = $"CodeFirstDemo.xml";//xml路径
XmlDocument xml = new XmlDocument();
xml.Load(xmlPath);

StringBuilder sbr = new StringBuilder();
XmlNodeList nodeList = xml.SelectNodes("//member");
foreach (XmlNode item in nodeList)
{
    string name = item.Attributes["name"].Value;
    if (name.IndexOf("P:CodeFirstDemo.TestContext.") > -1)
    {
        string property = name.Substring(name.LastIndexOf(".") + 1);
        string txtstr = item.InnerText.Replace(" ", "").Replace("\r", "").Replace("\n", "");
        sbr.AppendLine($"modelBuilder.Entity<{property}>(entity =>");
        sbr.AppendLine("{");
        sbr.AppendLine($"entity.HasComment(\"{txtstr}\");");
        foreach (XmlNode son in nodeList)
        {
            string sonname = son.Attributes["name"].Value;
            if (sonname.IndexOf($"P:CodeFirstDemo.Models.{property}.") > -1)
            {
                string sonproperty = sonname.Substring(sonname.LastIndexOf(".") + 1);
                string sontxtstr = son.InnerText
                    ?.Replace("\"", "\\\"")
                    ?.Replace(" ", "")
                    ?.Replace("\r", "")
                    ?.Replace("\n", "");
                if (sontxtstr.ToLower().IndexOf("[notmapped]") == -1)
                {
                    sbr.AppendLine($"entity.Property(t=>t.{sonproperty}).HasComment(\"{sontxtstr}\");");
                }
            }
        }
        sbr.AppendLine("});");
        sbr.AppendLine("");
    }
}
System.IO.File.WriteAllText("HasComment.txt", sbr.ToString());
Console.WriteLine(sbr);

执行之后,生成了txt文件

image.png

image.png


把txt里面的内容拷贝过去到TestContext.cs的OnModelCreating方法里面就可以了。

CarsonIT 微信扫码关注公众号 策略、创意、技术

留下您的脚步

 

最近评论

查看更多>>

站点统计

总文章数:275 总分类数:18 总评论数:88 总浏览数:124.83万

精选推荐

阅读排行

友情打赏

请打开您的微信,扫一扫