GraphQL Part VI: 使用 Postgres 和 EF Core 持久化数据

这次我们关注持久化数据而不是 GraphQL 方面。我们将使用 Postgres 数据库作为后端存储，您可能问：为什么要使用 Postgres？因为大家都熟悉 SQL Server，我们尝试一下新东西。

在数据访问层，我们将使用一个数据源类，或者说是一个仓储。基于抽象的最佳实践，我们首先创建数据源的接口，IDataStore

public interface IDataStore
{
    IEnumerable<Item> GetItems();
    Item GetItemByBarcode(string barcode);
}

我们已经用过 GetItemByBarcode 方法了，GetItems 方法返回库存的所有条目。我们随后将会添加一个 GraphQL 的集合。

实现该接口非常简单。

public class DataStore : IDataStore
{
    private ApplicationDbContext _applicationDbContext;

    public DataStore(ApplicationDbContext applicationDbContext)
    {
        _applicationDbContext = applicationDbContext;
    }

    public Item GetItemByBarcode(string barcode)
    {
        return _applicationDbContext.Items.First(i => i.Barcode.Equals(barcode));
    }

    public IEnumerable<Item> GetItems()
    {
        return _applicationDbContext.Items;
    }
}

我们使用 Entity Framework Core，这里我们引入 ApplicationDbContext。该类扩展自 Entity Framework 的 DbContext。现在它包含单个的关于 Item 实体的 DbSet 。这将会创建一个名为 Items 的表。

public class ApplicationDbContext : DbContext
{
    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : base(options)
    {

    }
    public DbSet<Item> Items { get; set; }
}

DbContextOptions 是很酷的传递参数的方式，例如数据库连接串 ConnectionString，在 Startup.cs 的 ConfigureServices 方法中配置 ApplicationDbContext。

services.AddEntityFrameworkNpgsql()
    .AddDbContext<ApplicationDbContext>(
        options => options.UseNpgsql(Configuration["DefaultConnection"]));  

AddEntityFrameworkNpgsql() 扩展方法来自独立的 Npgsql.EntityFrameworkCore.PostgreSQL 包。可以通过 Nuget 或者 dotnet CLI 安装：

dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 2.0.2

Configuration 属性来自类型 IConfigurationRoot。我们在 Startup.cs 的构造函数中构建配置对象，并赋予 Configuration 属性。

public IConfigurationRoot Configuration { get; set; }

public Startup(IHostingEnvironment env)
{
    var builder = new ConfigurationBuilder()
            .SetBasePath(env.ContentRootPath)
            .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
            .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);

    if (env.IsDevelopment())
    {
        builder.AddUserSecrets<Startup>();
    }

    builder.AddEnvironmentVariables();
    Configuration = builder.Build();
}

我们可以把数据库连接串保存在 appsettings.json 文件中，对于我来说，由于保密问题，我总是将它们保存在用户密钥文件中。这里的 builder.AddUserSecrets<Startup>()。你可以在用户密钥文件中如下添加数据库连接串。

dotnet user-secrets set DefaultConnection 'your-connection-string'

然后如下执行初始迁移的命令。

dotnet ef migrations add Initial --output-dir Data\Migrations

使用如下的命令应用迁移命令以创建数据库。

dotnet ef database update

AddDbContext<ApplicationDbContext>() 使用受限的服务生命周期注册 DbContext 。Singleton 和 scope 之间的区别是：

• Singleton 服务实例仅仅创建一次，在应用启动的时候。同样的实例被以后所有的请求所共享。
• Scopt 服务实例在每次被请求的时候重新创建

到目前为止，我们一直使用单例模式，但是，如果我们这样用于 IDataStore，会导致下面的问题：

• 如果你小心检查，我们将 ApplicationDbContext 直接注入到 DataStore，简单来说，我们在通过一个单例的服务访问 scoped 的服务。
• 尽管 scope 的服务实例会在每次请求的时候创建，但我们是从单例对象来访问它的，这导致永远返回第一次创建的实例，结果与单例一样了。

所以，我们必须也将 IDataStore 也注册为 scoped 。

services.AddScoped<IDataStore, DataStore>();

直至现在的 EF Core 2.0，我们仍然没有默认的 Seed 方法。所以，我们使用下面的方式准备一些数据。

public class ApplicationDatabaseInitializer
{
    public async Task SeedAsync(IApplicationBuilder app)
    {
        using (var scope = app.ApplicationServices.GetService<IServiceScopeFactory>().CreateScope())
        {
            var applicationDbContext = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();

            await applicationDbContext.Database.EnsureDeletedAsync();
            await applicationDbContext.Database.MigrateAsync();
            await applicationDbContext.Database.EnsureCreatedAsync();

            var items = new List<Item>
            {
                new Item { Barcode= "123", Title="Headphone", SellingPrice=50},
                new Item { Barcode= "456", Title="Keyboard", SellingPrice= 40},
                new Item { Barcode= "789", Title="Monitor", SellingPrice= 100}
            };

            await applicationDbContext.Items.AddRangeAsync(items);

            await applicationDbContext.SaveChangesAsync();
        }
    }
}

一旦我们应用启动，我们期望初始化数据，所以，在 Configure 方法中添加如下代码行。

new ApplicationDatabaseInitializer().SeedAsync(app).GetAwaiter();

一旦进入产品阶段，我们就不再需要这些种子数据。所以，这里并不介意使用 new 来创建对象实例。

其它的调整包括变更服务的生命周期：

services.AddScoped<HelloWorldQuery>();
services.AddScoped<ISchema, HelloWorldSchema>(); 

此刻，应用可以运行但是不能注册该架构。要记住 .net core 中间件仅在第一次启动的时候注册。但是在中间件中使用 scoped/transient 服务，我们就需要调用 InvokeAsync() 方法了。

public async Task InvokeAsync(HttpContext httpContext, ISchema schema)
{
    ....
    ....
}

最后，我希望添加一个新的集合类型的字段，以用于 Items，该字段的类型应该是 ItemType 的 ListGraphType 。

Field<ListGraphType<ItemType>>(
    "items",
    resolve: context =>
    {
        return dataStore.GetItems();
    }
);

运行应用，查询 items，你将收到如下的结果。