浅谈 EF CORE 迁移和实例化的几种方式

出于学习和测试的简单须要，使用 Console 来做为 EF CORE 的承载程序是最合适不过的。今天笔者就将平时的几种使用方式总结成文，以供参考，同时也是给本人一个温故知新的机会。由于没有一个完整的脉络，因此也只是想起什么写点什么，不通顺的地方还请多多谅解。

本文对象数据库默认为 VS 自带的 LocalDB

1. Normal & Simple

先介绍一种最简单的构建方式，人人都会。

• 新建 Console 应用程序，命名自定

• 安装相关Nuget 包

//Sql Server Database Provider
Install-Package Microsoft.EntityFrameworkCore.SqlServer
    
//提供熟悉的Add-Migration，Update-Database等Powershell命令，不区分关系型数据库类型
Install-Package Microsoft.EntityFrameworkCore.Tools

• 自定义 DbContext

public class MyContext:DbContext
{
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");
    }
}

• 执行迁移和更新命令

Add-Migration Initialize
Update-Database

• 使用方式

using (var context = new MyContext())
{
    // TODO
}

刚以上，咱们便见识到了了一种最日常也是最简单的使用方式，接下来，让咱们用其余方式去慢慢地改造它，从而尽量地接触更多的用法。

2. Level Up

2.1 准备工做

将第一步生成的数据库，迁移文件和使用方式内容所有删除。

2.2 更新 MyContext 内容

删除 MyContext 中的 OnConfiguring 方法及其内容，增长含有 DbContextOptions 类型参数的构造器，咱们的MyContext看起来应该是下面这个样子。

public class MyContext : DbContext
{
    public MyContext(DbContextOptions options) : base(options)
    {
    }
}

假如咱们此时仍然再执行迁移命令，VS将提示如下错误

No parameterless constructor was found on 'MyContext'. Either add a parameterless constructor to 'MyContext' or add an implementation of 'IDbContextFactory ' in the same assembly as 'MyContext'.

添加无参构造器的方式以后再讲解，先来按照提示信息添加一个 IDbContextFactory 的实现类。

public class MyContextFactory : IDbContextFactory<MyContext>
{
    public MyContext Create(DbContextFactoryOptions options)
    {
        var optionsBuilder = new DbContextOptionsBuilder<MyContext>();
        optionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");
            
        return new MyContext(optionsBuilder.Options);
    }
}

以后再次运行迁移和更新数据库的命令也是水到渠成。

2.3 使用方式：构造器实例化

既然 MyContext 含有 DbContextOptions 类型参数的构造器，那就手动建立一个参数实例注入便可。

var contextOptionsBuilder = new DbContextOptionsBuilder<MyContext>();
contextOptionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");

// 注入配置选项
using (var context = new MyContext(contextOptionsBuilder.Options))
{
    // TODO
}

经此，咱们知道了迁移命令会检测 Context 的相关配置入口，只有在知足存在 OnConfiguring 方法或者存在自建 IDbContextFactory 实现类的状况下，命令才能成功运行。

3. Day Day Up

目前为止，咱们已经知道如何手动迁移和实例化 Context 的步骤了因此让咱们更进一步。写过 ASP.NET CORE 的人可能知道在 ASP.NET CORE 中，Context 经常以依赖注入的方式引入到咱们的 Web 层，Service 层，或者 XXCore 层中（话说笔者最近最喜欢的解决方案开发架构就是伪 DDD 的四层架构，有空再介绍吧）。其实在 Console 应用中，这也能够很容易实现，具体的依赖注入引入能够参考笔者的上一篇博客，因此最终的代码效果以下：

var serviceCollection = new ServiceCollection();
serviceCollection.AddDbContext<MyContext>(c =>
{
    c.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");
});

var serviceProvider = serviceCollection.BuildServiceProvider();

using (var context = serviceProvider.GetService<MyContext>())
{
    //context.Database.Migrate();
}

至此，咱们便基本完成了本文的主题，惟一有些美中不足的是咱们的数据库链接字符串好像处处都是，这不是什么大问题，笔者直接将 Configuration 的配置代码贴在下面，这也是 ABP 中的方式。

public class AppConfigurations
{
    private static readonly ConcurrentDictionary<string, IConfigurationRoot> ConfigurationCache;

    static AppConfigurations()
    {
        ConfigurationCache = new ConcurrentDictionary<string, IConfigurationRoot>();
    }

    public static IConfigurationRoot Get(string environmentName = null)
    {
        var cacheKey = "#" + environmentName;
        return ConfigurationCache.GetOrAdd(
            cacheKey,
            _ => BuildConfiguration(environmentName)
        );
    }

    private static IConfigurationRoot BuildConfiguration(string environmentName = null)
    {
        var builder = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", true, true);

        if (!string.IsNullOrWhiteSpace(environmentName))
            builder = builder.AddJsonFile($"appsettings.{environmentName}.json", true);

        builder = builder.AddEnvironmentVariables();

        return builder.Build();
    }
}

这个工具类的使用方式就再也不赘述了。

4. 结尾

最后，想必会有人问为何要折腾这样一个小小的 Console 应用呢？其实经过这样一步步下来，咱们能够发现一些项目功能上的亮点，好比既然能够自配置 DbContext 的 Option 选项，同时咱们也知道了如何在类库和 Console 项目中添加依赖注入以及 Configuration 提取连接参数的功能，那针对三层架构或是 DDD 项目增长含真实数据库或是内存数据库（InMemory）的单元测试，或者是自动Migrate Context 和更新数据库也将是十分简单的一件事，至少看起来会比官方的示例更加真实和具备可操做性。而这部份内容笔者也将会在以后的博文中给出。

个人博客即将搬运同步至腾讯云+社区，邀请你们一同入驻：https://cloud.tencent.com/developer/support-plan