1. 程式人生 > >(22)ASP.NET Core EF建立模型(索引、備用鍵、繼承、支援欄位)

(22)ASP.NET Core EF建立模型(索引、備用鍵、繼承、支援欄位)

1.索引

索引是跨多個數據儲存區的常見概念。儘管它們在資料儲存中的實現可能會有所不同,但也可用於基於列(或一組列)更高效地進行查詢。

1.1約定

按照約定,將在用作外來鍵的每個屬性(或一組屬性)中建立索引。

1.2資料批註

不能使用資料批註建立索引。

1.3Fluent API

您可以使用熟知的API來指定單個屬性的索引。預設情況下,索引不是唯一的。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Blog>()
            //配置索引
            .HasIndex(b => b.Url);
    }
}
public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
}

您還可以指定索引應是唯一的,這意味著對於給定的屬性,不能有兩個實體具有相同的值。

modelBuilder.Entity<Blog>()
.HasIndex(b => b.Url)
.IsUnique();

您還可以為多個列指定索引。

class MyContext : DbContext
{
    public DbSet<Person> People { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Person>()
            .HasIndex(p => new { p.FirstName, p.LastName });
    }
}
public class Person
{
    public int PersonId { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
}

2.備用鍵

備用鍵與主鍵相對,用作每個實體例項的備用唯一識別符號。備用鍵可用作關係的目標。使用關係資料庫時,這將對映到備用鍵列上的唯一索引/約束和引用列的一個或多個外來鍵約束的概念。系統通常會在需要時為你引入備用鍵,你無需手動配置它們。

2.1約定

按照約定,系統將在識別屬性(不是主鍵)時為你引入備用鍵,充當關係的目標。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Post>()
            .HasOne(p => p.Blog)
            .WithMany(b => b.Posts)
            .HasForeignKey(p => p.BlogUrl)
            .HasPrincipalKey(b => b.Url);
    }
}
public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    
    public List<Post> Posts { get; set; }
}
public class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
    //備用鍵
    public string BlogUrl { get; set; }
    public Blog Blog { get; set; }
}

2.2資料註釋

不能使用資料註釋配置備用鍵。

2.3Fluent API

你可以使用熟知的API將單個屬性配置為備用金鑰。

class MyContext : DbContext
{
    public DbSet<Car> Cars { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Car>()
            //配置為備用金鑰
            .HasAlternateKey(c => c.LicensePlate);
    }
}
class Car
{
    public int CarId { get; set; }
    public string LicensePlate { get; set; }
    public string Make { get; set; }
    public string Model { get; set; }
}
你還可以使用熟知的API將多個屬性配置為備用金鑰(稱為複合備用鍵)。
class MyContext : DbContext
{
    public DbSet<Car> Cars { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Car>()
            //配置為備用金鑰
            .HasAlternateKey(c => new { c.State, c.LicensePlate });
    }
}
class Car
{
    public int CarId { get; set; }
    public string State { get; set; }
    public string LicensePlate { get; set; }
    public string Make { get; set; }
    public string Model { get; set; }
}

3.繼承

EF模型中的繼承用於控制如何在資料庫中表示實體類中的繼承。

3.1約定

按照約定,由資料庫提供商確定如何在資料庫中表示繼承。有關如何使用關係資料庫提供程式來處理此情況的詳細說明。如果模型中顯式包括兩個或更多個繼承型別,則EF僅會設定繼承。EF不會掃描模型中未包含的基型別或派生型別。可以通過為繼承層次結構中的每個型別公開DbSet,在模型中包含型別。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<RssBlog> RssBlogs { get; set; }
}
public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
}
public class RssBlog : Blog
{
    public string RssUrl { get; set; }
}

如果不想公開層次結構中一個或多個實體的DbSet,可以使用熟知的API來確保它們包含在模型中。如果不依賴約定,則可以使用HasBaseType顯式指定基型別。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<RssBlog>().HasBaseType<Blog>();
    }
}

4.支援欄位

支援欄位允許EF讀取和寫入欄位,而不是屬性。當使用類中的封裝來限制或通過應用程式程式碼對資料訪問進行限制時,這可能很有用,但在不使用這些限制的情況下,應從資料庫中讀取或寫入值。

4.1約定

按照約定,將發現以下欄位作為給定屬性的支援欄位(按優先順序順序列出)。僅為模型中包含的屬性發現欄位。

public class Blog
{
    private string _url;
    public int BlogId { get; set; }
    public string Url
    {
        get { return _url; }
        set { _url = value; }
    }
}

配置了支援欄位後,當從資料庫具體化實體例項(而不是使用屬性資源庫)時,EF將直接寫入該欄位。如果EF需要在其他時間讀取或寫入值,則它將使用屬性(如果可能)。例如,如果EF需要更新某個屬性的值,則它將使用屬性setter(如果已定義)。如果該屬性為只讀,則它將寫入欄位。

4.2資料註釋

不能通過資料批註配置支援欄位。

4.3Fluent API

你可以使用熟知的API來配置屬性的支援欄位。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Blog>()
            .Property(b => b.Url)
            .HasField("_validatedUrl");
    }
}
public class Blog
{
    private string _validatedUrl;
    public int BlogId { get; set; }
    public string Url
    {
        get { return _validatedUrl; }
    }
    public void SetUrl(string url)
    {
        using (var client = new HttpClient())
        {
            var response = client.GetAsync(url).Result;
            response.EnsureSuccessStatusCode();
        }
        _validatedUrl = url;
    }
}
4.3.1控制何時使用欄位

可以配置EF何時使用欄位或屬性。有關支援的選項,請參閱PropertyAccessMode列舉。

modelBuilder.Entity<Blog>()
    .Property(b => b.Url)
    .HasField("_validatedUrl")
    .UsePropertyAccessMode(PropertyAccessMode.Field);
4.3.2沒有屬性的欄位

你還可以在你的模型中建立一個概念屬性,該屬性在實體類中不具有相應的CLR屬性,而是使用欄位來儲存實體中的資料。這不同於陰影屬性,其中的資料儲存在更改跟蹤器中。如果實體類使用方法獲取或設定值,通常會使用此方法。可以在Property(...) API中為EF指定欄位的名稱。如果沒有具有給定名稱的屬性,則EF將查詢欄位。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Blog>()
            .Property("_validatedUrl");
    }
}
public class Blog
{
    private string _validatedUrl;
    public int BlogId { get; set; }
    public string GetUrl()
    {
        return _validatedUrl;
    }
    public void SetUrl(string url)
    {
        using (var client = new HttpClient())
        {
            var response = client.GetAsync(url).Result;
            response.EnsureSuccessStatusCode();
        }
        _validatedUrl = url;
    }
}

您還可以選擇為屬性指定名稱,而不是欄位名稱。然後,在建立模型時使用此名稱,最值得注意的是,該名稱將用於在資料庫中對映到的列名稱。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property<string>("Url")
        .HasField("_validatedUrl");
}

如果實體類中沒有屬性,則可以在LINQ查詢中使用EF.Property(...)方法來引用概念上是模型的一部分的屬性。

var blogs = db.blogs.OrderBy(b => EF.Property<string>(b, "Url"));


參考文獻:
索引
備用鍵
繼承
支援