Přidání modelů a kontrolerů

Stáhnout dokončený projekt

V této části přidáte třídy modelů, které definují databázové entity. Pak přidáte kontrolery webového rozhraní API, které provádějí operace CRUD s těmito entitami.

Přidání tříd modelů

V tomto kurzu vytvoříme databázi pomocí přístupu Code First k Entity Frameworku (EF). Pomocí code First napíšete třídy jazyka C#, které odpovídají databázovým tabulkám, a EF vytvoří databázi. (Další informace naleznete v tématu Přístupy k vývoji entity Framework.)

Začneme definováním objektů domény jako objektů POCO (prostých objektů CLR). Vytvoříme následující POCOs:

• Author
• Kniha

V Průzkumníku řešení klikněte pravým tlačítkem myši na složku Modely. Vyberte Přidat a pak vyberte Třída. Pojmenujte třídu Author.

Nahraďte veškerý šablonový kód v Author.cs následujícím kódem.

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; }
    }
}

Přidejte další třídu s názvem Book, s následujícím kódem.

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 bude tyto modely používat k vytváření databázových tabulek. U každého modelu Id se vlastnost stane sloupcem primárního klíče v tabulce databáze.

Ve třídě AuthorId Book definuje cizí klíč do tabulky Author. (Pro jednoduchost předpokládám, že každá kniha má jednoho autora.) Třída knihy obsahuje také navigační vlastnost související Author. Pomocí navigační vlastnosti můžete získat přístup ke souvisejícímu Author kódu. Říkám více o navigačních vlastnostech v části 4, zpracování vztahů entit.

Přidání kontrolerů webového rozhraní API

V této části přidáme kontrolery webového rozhraní API, které podporují operace CRUD (vytvoření, čtení, aktualizace a odstranění). Kontrolery budou používat Entity Framework ke komunikaci s databázovou vrstvou.

Nejprve můžete odstranit soubor Controllers/ValuesController.cs. Tento soubor obsahuje příklad kontroleru webového rozhraní API, ale pro účely tohoto kurzu ho nepotřebujete.

Dále sestavte projekt. Generování uživatelského rozhraní Web API používá reflexi k vyhledání tříd modelu, takže potřebuje zkompilované sestavení.

V Průzkumníku řešení klikněte pravým tlačítkem myši na složku Kontrolery. Vyberte Přidat a pak vyberte Kontroler.

V dialogovém okně Přidat scaffolding vyberte "Kontroler webového rozhraní API 2 s akcemi pomocí Entity Framework". Klikněte na tlačítko Přidat.

V dialogovém okně Přidat kontroler postupujte takto:

1. V rozevíracím seznamu Třída modelu vyberte Author třídu. (Pokud ho v rozevíracím seznamu nevidíte, ujistěte se, že jste projekt vytvořili.)
2. Zaškrtněte políčko Použít akce asynchronního kontroleru.
3. Název kontroleru ponechte jako "AuthorsController".
4. Klikněte na tlačítko plus (+) vedle třídy kontextu dat.

V dialogovém okně Nový kontext dat ponechte výchozí název a klikněte na Přidat.

Kliknutím na Přidat dokončete dialogové okno Přidat kontroler . Dialogové okno přidá do projektu dvě třídy:

• AuthorsController definuje kontroler webového rozhraní API. Kontroler implementuje rozhraní REST API, které klienti používají k provádění operací CRUD v seznamu autorů.
• BookServiceContext spravuje objekty entit během doby běhu, což zahrnuje naplnění objektů dat z databáze, sledování změn a zachování dat do databáze. Dědí z DbContext.

V tomto okamžiku znovu sestavte projekt. Teď projděte stejným postupem přidání kontroleru rozhraní API pro Book entity. Tentokrát vyberte Book pro třídu modelu a vyberte existující BookServiceContext třídu pro třídu kontextu dat. (Nevytvávejte nový kontext dat.) Kliknutím na Přidat přidáte kontroler.

PředchozíDalší