前言

在本部分中，你將添加用于定義數(shù)據(jù)庫實體的模型類。然后你將添加用于在這些實體上執(zhí)行CRUD（Create、Retrieve、Update、Delete——譯者注）操作的Web API 控制器。

添加模型類

在本教程中，我們將通過使用“Code First”的方法對實體框架（EF）來創(chuàng)建數(shù)據(jù)庫。對于Code First，你寫C#類來相應(yīng)數(shù)據(jù)庫表，使用EF來創(chuàng)建數(shù)據(jù)庫。（有關(guān)詳細信息，見Entity Framework Development Approaches.）

首先，我們定義我們的域?qū)ο笞鳛镻OCO。我們將創(chuàng)建以下POCO： Author Book

在解決方案資源管理中，右擊Models文件夾。選擇Add，然后選擇Class。名為這個類為Author。

用以下代碼替換Author.cs中的所有樣板代碼。

using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace BookService.Models
{
    public class Author
    {
        public int Id { get; set; }
        [Required]
        public string Name { get; set; }
    }
}

添加另一個命名為Book的類，并替換成以下代碼。

using System.ComponentModel.DataAnnotations;

namespace BookService.Models
{
    public class Book
    {
        public int Id { get; set; }
        [Required]
        public string Title { get; set; }
        public int Year { get; set; }
        public decimal Price { get; set; }
        public string Genre { get; set; }

        // Foreign Key
        public int AuthorId { get; set; }
        // Navigation property
        public Author Author { get; set; }
    }
}

Entity Framework將使用這些模型來創(chuàng)建數(shù)據(jù)庫表。對于每一個模型，Id屬性將變成數(shù)據(jù)庫表的主鍵列。

在Book類中，AuthorId定義了一個外鍵到Author表。（簡單起見，我假定每本書只有一個作者。）該book類還包含一個導(dǎo)航屬性給相關(guān)的Author。 你可以使用導(dǎo)航屬性在代碼中訪問相關(guān)的作者。我在【W(wǎng)eb API系列教程】3.4 — 實戰(zhàn)：處理數(shù)據(jù)（處理實體關(guān)系） 中描述了關(guān)于導(dǎo)航屬性的更多信息。

添加Web API 控制器

在這部分，我們將添加支持CRUD（create, read, update 和 delete）的Web API 控制器。這些控制器使用Entity Framework來同數(shù)據(jù)庫層交流。

首先，你應(yīng)該刪除Controllers目錄下的ValuesControllers.cs文件。這個文件包含了一個Web API示例，但對于本教程你并不需要它。

然后，編譯這個項目。Web API框架使用反射來發(fā)現(xiàn)這個模型類，所以它需要編譯程序集。

在Solution Explorer中，右擊Controllers文件夾。選擇Add，然后選擇Controller。

在Add Scaffold對話框中，選擇“Web API 2 controller with actions, using Entity Framework”。點擊Add。

在Add Controller對話框中，執(zhí)行以下操作： 1， 在模型類下拉框中，選擇Author類。（如果你沒有在下拉框中看到它，請確保已經(jīng)編譯了這個項目。） 2， 選中“Use async controller action”。 3， 保留控制器名稱為“AuthorsController”。 4， 點擊加號（+）按鈕下一步到Data Context Class.

在New Data Context對話框中，保留默認名稱并點擊Add。

點擊Add以完成Add Controller對話框。這個對話將添加兩個類到你的項目中： AuthorsController定義了一個Web API控制器。這個控制器實現(xiàn)了REST API，客戶端使用它來在authors列表上執(zhí)行CRUD操作。 BookServiceContext在運行時管理實體對象，包括從數(shù)據(jù)庫中聚集對象數(shù)據(jù)、追蹤、保留數(shù)據(jù)到數(shù)據(jù)庫。它繼承自DBContext。

在這個節(jié)點上，再次編譯這個項目?，F(xiàn)在再過一遍相同的步驟為Book實體添加API控制器。這次選擇Book作為模型類，并選擇已經(jīng)存在的BookServiceContext類作為數(shù)據(jù)上下文類。（不要再創(chuàng)建新的數(shù)據(jù)上下文。）點擊Add以添加該控制器。