出於學習和測試的簡單需要,使用 Console 來作為 EF CORE 的承載程式是最合適不過的。今天筆者就將平時的幾種使用方式總結成文,以供參考,同時也是給本人一個溫故知新的機會。因為沒有一個完整的脈絡,所以也只是想起什麼寫點什麼,不通順的地方還請多多諒解。 本文對象資料庫預設為 VS 自帶的 L ...
出於學習和測試的簡單需要,使用 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 和更新資料庫也將是十分簡單的一件事,至少看起來會比官方的示例更加真實和具有可操作性。而這部分內容筆者也將會在之後的博文中給出。