ASP.NET Core：使用EntityFrameworkCore操作MySql来丰富仓储模块

概述

上一篇简单介绍了Dapper的基本用法，数据的存储为SqlServer。那么这一篇就记录一下使用EFCore来操作MySql的一些方式，这种模式比较适合那种一个项目中需要操作多种数据库的模式。不过因为微软官方并没有提供其驱动，所以我们需要借助MySql官方提供的驱动进行基本的增删改查操作。这样一来我们也可以将数据库迁移到Linux服务器上了，是不是很激动。当然了，Sql Server Love Linux！大家同样是有目共睹，SQL Server 2017 Preview版本也已经支持在Linux上部署，但是当我看到需要至少3.25G的内存的时候，我是有点小情绪的，有要了解的话大家可以移步这里，很期待微软下一步会有什么样的大动作！好了，正文开始。

一、在Windows上安装并配置MySql

1、先到官网上下载最新的发行版本5.7.18（社区版），选择mysql-installer-community-5.7.18.1.msi，因为它已经包含了Server和Workbench。

2、双击下载好的文件开始安装，这个版本的安装体验自我感觉已经比5.5的好了很多。如果嫌麻烦的话，你可以直接选择第一个选项“Developer Default”——默认的开发环境来进行安装，非常省事。不过我是一个.Netor，有些内容并不是必须的，所以我选择“Customer”自定义来进行安装了，接着下一步、

3、下面我列出来自定义选择的一些安装内容简介

MySQL Server	MySQL 服务器（必不可少，你懂的~）
MySQL Workbench	MySQL的数据库建模工具（类似于SQL Server Management Studio）
MySQL Notifier	MySQL的DBA辅助工具（安装好之后右下角会有一个小托盘）
Connector/ODBC	数据库与应用程序的互连标准
Connnector/NET	.NET程序的数据库驱动

其他一些高级功能比如MySQL Router，VS的可视化连接工具，Shell，文档介绍等等就暂时忽略，以后需要的话可以随时安装

4、接下来选择一个安装路径，然后点击Execute进行安装即可

5、服务器配置类型选择开发环境“Development Machine”，端口默认3306，然后下一步

6、然后给Root账户设置一个密码。其他账户你可以选择暂时不添加，继续下一步

7、将MySQL配置成一个Windows服务，并设置为开机启动

8、应用你的所有配置，并完成安装。整个过程耗时还是挺少的

9、启动MySQL，输入你刚才设置的root账户的密码进行登陆。出现以下页面，说明已经大功告成。

二、添加MySql.Data.EntityFrameworkCore到仓储模块

1、打开工具=》Nuget包管理器=》程序包管理控制台，输入以下命令进行包的安装，同时依赖也会跟着一起引入到项目中去

Install-Package MySql.Data.EntityFrameworkCore -Pre

几个注意点这里说明一下：

a）、通过Nuget包管理器界面进行安装的时候记得勾选“包括预发行版”，然后再进行搜索

b）、命令行记得带上“-Pre”，表示预发行版本

c）、安装的默认项目时选择仓储模块Light.Repository

2、构建MySQL数据库上下文，注意红色字体的描述

    /// <summary>
    /// MySQL数据库访问上下文
    /// </summary>
    public class LightContext : DbContext
    {
        public LightContext(DbContextOptions<LightContext> options)
            : base(options)
        {
        }

        public DbSet<User> User { get; set; }
    }

    /// <summary>
    /// MySQL的数据库配置
    /// </summary>
    public class MySQLDataBaseConfig
    {
        /// <summary>
        /// 默认的MySQL的链接字符串
        /// </summary>
        private const string DefaultMySqlConnectionString = "server=localhost;userid=root;pwd=sasa;port=3306;database=light;";
        public static LightContext CreateContext(string mySqlConnectionString = null)
        {
            if (string.IsNullOrWhiteSpace(mySqlConnectionString))
            {
                mySqlConnectionString = DefaultMySqlConnectionString;
            }
            var optionBuilder = new DbContextOptionsBuilder<LightContext>();
            optionBuilder.UseMySQL(mySqlConnectionString);
            var context = new LightContext(optionBuilder.Options);
            context.Database.EnsureCreated();//针对当前访问的上下文对象，如果数据库中存在该表，则不做修改；否则的话进行创建
            return context;
        }
    }

3、接下来就是用我们准备好的数据库上下文对用户进行简单的CRUD操作。因为得益于面向接口编程和DI的思想，只需要用EF的方式实现IUserRepository中定义的方法，然后将此注入仓储即可

    /// <summary>
    /// MySql中的用户仓储实现
    /// </summary>
    public class UserRepositoryMySql : IUserRepository
    {
        /// <summary>
        /// 创建一个用户
        /// </summary>
        /// <param name="entity">用户</param>
        /// <param name="connectionString">链接字符串</param>
        /// <returns></returns>
        public bool CreateEntity(User entity, string connectionString = null)
        {
            using (LightContext context = MySQLDataBaseConfig.CreateContext(connectionString))
            {
                context.User.Add(entity);
                return context.SaveChanges() > ;
            }
        }

        /// <summary>
        /// 根据主键Id删除一个用户
        /// </summary>
        /// <param name="id">主键Id</param>
        /// <param name="connectionString">链接字符串</param>
        /// <returns></returns>
        public bool DeleteEntityById(int id, string connectionString = null)
        {
            using (LightContext context = MySQLDataBaseConfig.CreateContext(connectionString))
            {
                context.User.Remove(context.Find<User>(id));
                return context.SaveChanges() > ;
            }
        }

        /// <summary>
        /// 获取所有用户
        /// </summary>
        /// <param name="connectionString">链接字符串</param>
        /// <returns></returns>
        public IEnumerable<User> RetriveAllEntity(string connectionString = null)
        {
            using (LightContext context = MySQLDataBaseConfig.CreateContext(connectionString))
            {
                List<User> allUsers = new List<User>();
                allUsers.AddRange(context.User);
                return allUsers;
            }
        }

        /// <summary>
        /// 根据主键Id获取一个用户
        /// </summary>
        /// <param name="id">主键Id</param>
        /// <param name="connectionString">链接字符串</param>
        /// <returns></returns>
        public User RetriveOneEntityById(int id, string connectionString = null)
        {
            using (LightContext context = MySQLDataBaseConfig.CreateContext(connectionString))
            {
                return context.Find<User>(id);
            }
        }

        /// <summary>
        /// 修改一个用户
        /// </summary>
        /// <param name="entity">要修改的用户</param>
        /// <param name="connectionString">链接字符串</param>
        /// <returns></returns>
        public bool UpdateEntity(User entity, string connectionString = null)
        {
            using (LightContext context = MySQLDataBaseConfig.CreateContext(connectionString))
            {
                context.Update<User>(entity);
                return context.SaveChanges() > ;
            }
        }
    }

    /// <summary>
    /// 注入仓储层
    /// </summary>
    public class RepositoryInjection
    {
        public static void ConfigureRepository(IServiceCollection services)
        {
            //services.AddSingleton<IUserRepository, UserRepository>();
            services.AddSingleton<IUserRepository, UserRepositoryMySql>();
        }
    }

4、至此，你上层的所有代码不用进行任何的变动，系统便从SqlServer切换到了MySql上。然后试着用API插入一个用户信息看看，是不是User表自动创建，并且产生了一条记录。

其实查看表结构不难发现，EF会默认将属性名为Id的int型作为主键，并且设置为自增。字符串string类型的话默认可空且长度为255，其他则非空。那么我们是否可以修改默认的表结构呢，答案肯定是：可以的

三、配置上下文中的数据库对象

1、在LightContext中重写模型绑定的方法OnModelCreating，然后设置对应实体属性的规则，这种方式叫做Fluent API

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
      modelBuilder.Entity<User>(m =>
      {
           m.Property(n => n.UserName).HasMaxLength();//设置用户名最大长度为50个字符
           m.Property(n => n.Password).HasMaxLength(20).IsRequired();//设置密码不可空且最大20个字符
      });
      base.OnModelCreating(modelBuilder);
}

2、本来想用Microsoft.EntityFrameworkCore.Tools结合dotnet ef相关命令直接进行更新数据库，但最后失败了

大致意思是说.NETStandard类库不适用此CLI，除非换成启动项目。然后查了下，官方也给出了解释

3、所以我这边偷了一个懒，直接删除刚刚生成的表，然后重新运行项目，这相当于重建了数据库表。接着查询下MySQL中User表的新结构，看看是不是已经发生了变化

四：总结

其实EF Core还有更多高级的用法，实体模型间的关系，数据库的迁移等等，需要我们更加深入的学习和实践。除了官方文档外，这里安利一个挺不错的学习网站：learnentityframeworkcore，那么就到这里了，共同进步！