Code First 中数据库初始化策略

怼烎@ 2021-06-26 16:06 353阅读 0赞

# Code First 中数据库初始化策略 #

## 00.00 Code First 中支持 4 种数据库初始化策略 ##

*  `CreateDatabaseIfNotExists`
    
    > 这是默认的初始化程序。顾名思义，如果没有配置，它将创建数据库。但是，如果更改模型类，然后使用该初始化程序运行应用程序，那么它将抛出异常
 *  `DropCreateDatabaseIfModelChanges`
    
    > 如果您的模型类（实体类）已更改，则此初始化程序将删除现有数据库并创建新数据库。因此，当您的模型类更改时，您无需担心维护数据库模式
 *  `DropCreateDatabaseAlways`
    
    > 顾名思义，该初始化程序在每次运行应用程序时都会删除现有数据库，而不管您的模型类是否已更改。当您需要新鲜数据库时，每次运行应用程序时，就像在开发应用程序时一样
 *  `Custom DB Initializer`
    
    > 您还可以创建自己的自定义初始化程序，如果上述任何一个都不满足您的要求，或者您想使用上述初始化程序初始化数据库的其他进程

## 01.00 使用方法 ##

public class YourDBContext: DbContext 
    { 
        public YourDBContext(): base("YourDBConnectionString") 
        { 
            Database.SetInitializer<YourDBContext>(new CreateDatabaseIfNotExists<YourDBContext>());
    
            //Database.SetInitializer<YourDBContext>(new DropCreateDatabaseIfModelChanges<YourDBContext>());
            //Database.SetInitializer<YourDBContext>(new DropCreateDatabaseAlways<YourDBContext>());
            //Database.SetInitializer<YourDBContext>(new YourDBInitializer());
        }
        public DbSet<Student> Students {  get; set; }
        public DbSet<Standard> Standards {  get; set; }
    }

## 02.00 创建自己的初始化器 ##

可以继承 4 种中的任意一种来实现自己的初始化器

public class YourDBInitializer :  CreateDatabaseIfNotExists<YourDBContext>
    { 
        protected override void Seed(YourDBContext context)
        { 
            base.Seed(context);
        }
    }

## 03.00 在配置文件设置数据库初始化器 ##

在 `app.config` 中设置

<?xml version="1.0" encoding="utf-8" ?>
    <configuration>
        <appSettings>
        <add key="DatabaseInitializerForType YourDataLayer.YourDBContext, YourDataLayer" value="System.Data.Entity.DropCreateDatabaseAlways`1[[YourDataLayer.YourDBContext, YourDataLayer]], EntityFramework" />
        </appSettings>
    </configuration>

在配置文件中使用自己的初始化器

<?xml version="1.0" encoding="utf-8" ?>
    <configuration>
        <appSettings>    
        <add key="DatabaseInitializerForType YourDataLayer.YourDBContext, YourDataLayer" value="YourDataLayer.YourDBInitializer, YourDataLayer" />
        </appSettings>
    </configuration>

## 04.00 Code First 中关闭数据库初始化器 ##

在生产环境中, 你不想丢失已经存在的数据, 那么你可以关闭初始化器

public class YourDBContext: DbContext 
    { 
        public YourDBContext() : base("YourDBContextDBConnectionString")
        {             
            //Disable initializer
            Database.SetInitializer<YourDBContext>(null);
        }
        public DbSet<Student> Students {  get; set; }
        public DbSet<Standard> Standards {  get; set; }
    }

在配置文件中关闭初始化器

<?xml version="1.0" encoding="utf-8" ?>
    <configuration>
        <appSettings>    
        <add key="DatabaseInitializerForType YourDataLayer.YourDBContext, YourDataLayer" value="Disabled" />
        </appSettings>
    </configuration>

--------------------

## `EntityTypeConfiguration` ##

### 00.00 `EntityTypeConfiguration` 简介 ###

在使用 Fluent API 之前, 先看一个非常重要的类: [EntityTypeConfiguration][]

[EntityTypeConfiguration][] 类提供了很多配置 实体或属性 的重要方法, 实现覆盖各种Code-First约定

### 00.01 `EntityTypeConfiguration` 来源 ###

大概知道了这个类能干嘛, 那它可以从哪里获得呢?

通常在我们的 `DbContext` 中，我们会重写 `OnModelCreating` 方法

protected override void OnModelCreating(DbModelBuilder modelBuilder)
    { 
        base.OnModelCreating(modelBuilder);
    }

此方法带有 `DbModelBuilder` 类型参数 `modelBuilder`，而 `modelBuilder.Entity<TEntity>()` 方法返回值类型就是 [EntityTypeConfiguration][]

把 `OnModelCreating` 方法更改为

protected override void OnModelCreating(DbModelBuilder modelBuilder)
    { 
        EntityTypeConfiguration<TEntity> tEntityCfg = modelBuilder.Entity<TEntity>();
        base.OnModelCreating(modelBuilder);
    }

此时我们就可以使用 `tEntityCfg` 来配置 `TEntity` 的实体或属性了

### 00.02 `EntityTypeConfiguration` 常用重要方法 ###

<table> 
 <thead> 
  <tr> 
   <th>方法名</th> 
   <th>返回类型</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>HasKey&lt;TKey&gt;</code></td> 
   <td><a href="http://msdn.microsoft.com/en-us/library/gg696117%28v=vs.103%29.aspx" rel="nofollow">EntityTypeConfiguration</a></td> 
   <td>为此实体配置主键属性</td> 
  </tr> 
  <tr> 
   <td><code>HasMany&lt;TTargetEntity&gt;</code></td> 
   <td><a href="http://msdn.microsoft.com/en-us/library/gg679342%28v=vs.103%29.aspx" rel="nofollow">ManyNavigationPropertyConfiguration</a></td> 
   <td>配置实体类型多对多关系</td> 
  </tr> 
  <tr> 
   <td><code>HasOptional&lt;TTargetEntity&gt;</code></td> 
   <td><a href="http://msdn.microsoft.com/en-us/library/gg696420%28v=vs.103%29.aspx" rel="nofollow">OptionalNavigationPropertyConfiguration</a></td> 
   <td>配置此实体类型的可选关系. 实体类型的实例可以保存到数据库，而不指定此关系. 数据库中的外键将为空.</td> 
  </tr> 
  <tr> 
   <td><code>HasRequired&lt;TTargetEntity&gt;</code></td> 
   <td><a href="http://msdn.microsoft.com/en-us/library/gg679232%28v=vs.103%29.aspx" rel="nofollow">RequiredNavigationPropertyConfiguration</a></td> 
   <td>配置此实体类型所需的关系. 实体类型的实例将无法保存到数据库，除非指定了该关系. 数据库中的外键将不可为空.</td> 
  </tr> 
  <tr> 
   <td><code>Ignore&lt;TProperty&gt;</code></td> 
   <td>Void</td> 
   <td>从模型中排除属性，使其不会映射到数据库.</td> 
  </tr> 
  <tr> 
   <td><code>Map</code></td> 
   <td><a href="http://msdn.microsoft.com/en-us/library/gg696117%28v=vs.103%29.aspx" rel="nofollow">EntityTypeConfiguration</a></td> 
   <td>允许与实体类型映射到数据库模式的高级配置相关.</td> 
  </tr> 
  <tr> 
   <td><code>Property&lt;T&gt;</code></td> 
   <td><a href="http://msdn.microsoft.com/en-us/library/gg679411%28v=vs.103%29.aspx" rel="nofollow">StructuralTypeConfiguration</a></td> 
   <td>配置在此类型上定义的struct属性.</td> 
  </tr> 
  <tr> 
   <td><code>ToTable</code></td> 
   <td>Void</td> 
   <td>配置此实体映射到数据库的名称.</td> 
  </tr> 
 </tbody> 
</table>

更多的方法可以查看 MSDN [EntityTypeConfiguration][EntityTypeConfiguration 1].

[EntityTypeConfiguration]: https://msdn.microsoft.com/en-us/library/gg696117%28v=vs.113%29.aspx
[EntityTypeConfiguration 1]: http://msdn.microsoft.com/en-us/library/gg696117%28v=vs.103%29.aspx