W artykule tym zostanie omówione podejście Code First. Zobaczymy również jakie są korzyści zastosowania takiego podejścia.

Zanim jednak przejdziemy do właściwej treści artykułu należy się skupić na nowoczesnym podejściu do projektowania aplikacji. Tradycyjne podejście do projektowania i tworzenia aplikacji to tzw. Data Driven Design. Oznacza to, iż w pierwszej kolejności myślimy o wymaganych danych niezbędnych do wypełnienia obiektu biznesowego a następnie przystępowaliśmy do tworzenia aplikacji na podstawie istniejącego schematu bazy danych. Podejście takie jest wciąż bardzo popularne i często używane. W takim wypadku powinniśmy używać podejścia Database First.

Alternatywnym podejściem jest Domain Driven Design. W podejściu tym myślimy o encjach i modelach, których potrzebujemy być rozwiązać pewien problem związany z obiektem biznesowym. Jeżeli potrzebujemy przechowywać aktualny stan naszych modeli możemy tego dokonać poprzez umieszczenie tych modeli w bazie danych. Innymi słowy, w pierwszej kolejności tworzymy model w naszej aplikacji a w kolejnym kroku możemy napisać logikę odpowiedzialną za wykonywanie operacji na tym modelu, np. zapisywanie wyników do relacyjnej bazy danych. Entity Framework Code First pozwala na tworzenie modeli aplikacji przy użyciu podejścia Domain Driven Design, które następnie mogą zostać zapisane w bazie danych.

EF pozwala nam na pisanie obiektów POCO (Plain Old CLR Object) dla naszych modeli a następnie na przechowywanie ich w bazie danych za pomocą definicji klasy DbContext. Poniżej kilka z korzyści płynących z zastosowania takiego podejścia:

• możliwość wsparcia projektowego Domain Driven Design;
• możliwość szybszego rozpoczęcia procesu tworzenia kodu (bez konieczności czekania na gotową bazę danych);
• klasy modeli są dużo czytelniejsze ponieważ nie zawierają logiki związanej z przechowywaniem modeli w bazie danych;
• warstwa przechowywania danych może być zmieniona bez żadnego wpływu na istniejące modele.

Czym w takim wypadku są obiekty POCO? Są to proste obiekty, które nie zawierają żadnej logiki związanej z dostępem do danych ale wciąż dostarczają możliwości takie jak lazy loading.

Adnotacja: Artykuł ten jest napisany z perspektywy osoby zupełnie początkującej, która stawia pierwsze kroki w takim podejściu projektowym. Zawiera jedynie podstawowe informacje oraz kod pozwalający na rozpoczęcie pracy zgodnej z takim podejściem.

Spróbujemy zrozumieć podejście Code First na przykładzie małej aplikacji webowej napisanej w technologii ASP.NET MVC. Aplikacja ta będzie pozwalała nam na:

1. Wyświetlenie listy wszystkich samochodów
2. Wyświetlenie szczegółów wybranego samochodu
3. Dodawanie nowych samochodów
4. Usuwanie samochodów
5. Edycje wcześniej zdefiniowanych samochodów
6. Dodawanie własnych komentarzy dotyczących wybranego samochodu

Patrząc na powyższe punkty potrzebujemy dwóch modeli. Pierwszy dla samochodów a drugi dla komentarzy.

Tworzenie POCO’s

Zacznijmy od utworzenia prostych modeli:

public class CarModel
{
    public int CarId { get; set; }
    public string Brand { get; set; }
    public string Model { get; set; }
}

public class CommentModel
{
    public int Id { get; set; }
    public int CarId { get; set; }
    public string Comment { get; set; }
}

[Table("Cars")] // za pomocą atrybutu nadajemy nazwę naszej tabeli
public class CarModel
{
    [Key] // ustawiamy klucz główny tabeli
    public int CarId { get; set; }
    public string Brand { get; set; }
    public string Model { get; set; }
    // do każdego samochodu możemy przypisać wiele komentarzy
    public virtual ICollection<CommentModel> Comments { get; set; }
}

[Table("Comments")]  // za pomocą atrybutu nadajemy nazwę naszej tabeli
public class CommentModel
{
    [Key]  // ustawiamy klucz główny tabeli
    public int Id { get; set; }
    [ForeignKey("Cars")] // ustawiamy klucz obcy
    public int CarId { get; set; }
    public string Comment { get; set; }
    // będziemy widzieli, które samochody przynależą do tego komentarza
    public virtual CarModel Cars { get; set; }
}

public class CarDbContext : DbContext
{
    // Your context has been configured to use a 'CarDbContext' connection string from your application's 
    // configuration file (App.config or Web.config). By default, this connection string targets the 
    // 'EF_CodeFirstApproach.CarDbContext' database on your LocalDb instance. 
    // 
    // If you wish to target a different database and/or database provider, modify the 'CarDbContext' 
    // connection string in the application configuration file.
    public CarDbContext()
        : base("name=CarDbContext")
    {
    }
    // Add a DbSet for each entity type that you want to include in your model. For more information 
    // on configuring and using a Code First model, see http://go.microsoft.com/fwlink/?LinkId=390109.
    // public virtual DbSet MyEntities { get; set; }
}

public class CarDbContext : DbContext
{
    public CarDbContext()
        : base("name=CarDbContext")
    {
    }
    public DbSet<CarModel> Cars { get; set; }
    public DbSet<CommentModel> Comments { get; set; }
}

<add name="CarDbContext" connectionString="data source=(LocalDb)\MSSQLLocalDB;initial catalog=EF_CodeFirstApproach.CarDbContext;
    integrated security=True;MultipleActiveResultSets=True;App=EntityFramework" providerName="System.Data.SqlClient" />

<add name="CarDbContext" connectionString="data source=(LocalDb)\MSSQLLocalDB;AttachDbFilename=C:\Users\PawelL\Desktop\sampleDb.mdf;
        integrated security=True;MultipleActiveResultSets=True;App=EntityFramework" providerName="System.Data.SqlClient" />

using System.Data.Entity;
using System.Linq;
using System.Net;
using System.Web.Mvc;
using EF_CodeFirstApproach.Models;
namespace EF_CodeFirstApproach.Controllers
{
    public class CarsController : Controller
    {
        private CarDbContext db = new CarDbContext();
        // GET: CarModels
        public ActionResult Index()
        {
            return View(db.Cars.ToList());
        }
        // GET: CarModels/Details/5
        public ActionResult Details(int? id)
        {
            if (id == null)
            {
                return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
            }
            CarModel carModel = db.Cars.Find(id);
            if (carModel == null)
            {
                return HttpNotFound();
            }
            return View(carModel);
        }
        // GET: CarModels/Create
        public ActionResult Create()
        {
            return View();
        }
        // POST: CarModels/Create
        // To protect from overposting attacks, please enable the specific properties you want to bind to, for 
        // more details see http://go.microsoft.com/fwlink/?LinkId=317598.
        [HttpPost]
        [ValidateAntiForgeryToken]
        public ActionResult Create([Bind(Include = "CarId,Brand,Model")] CarModel carModel)
        {
            if (ModelState.IsValid)
            {
                db.Cars.Add(carModel);
                db.SaveChanges();
                return RedirectToAction("Index");
            }
            return View(carModel);
        }
        // GET: CarModels/Edit/5
        public ActionResult Edit(int? id)
        {
            if (id == null)
            {
                return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
            }
            CarModel carModel = db.Cars.Find(id);
            if (carModel == null)
            {
                return HttpNotFound();
            }
            return View(carModel);
        }
        // POST: CarModels/Edit/5
        // To protect from overposting attacks, please enable the specific properties you want to bind to, for 
        // more details see http://go.microsoft.com/fwlink/?LinkId=317598.
        [HttpPost]
        [ValidateAntiForgeryToken]
        public ActionResult Edit([Bind(Include = "CarId,Brand,Model")] CarModel carModel)
        {
            if (ModelState.IsValid)
            {
                db.Entry(carModel).State = EntityState.Modified;
                db.SaveChanges();
                return RedirectToAction("Index");
            }
            return View(carModel);
        }
        // GET: CarModels/Delete/5
        public ActionResult Delete(int? id)
        {
            if (id == null)
            {
                return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
            }
            CarModel carModel = db.Cars.Find(id);
            if (carModel == null)
            {
                return HttpNotFound();
            }
            return View(carModel);
        }
        // POST: CarModels/Delete/5
        [HttpPost, ActionName("Delete")]
        [ValidateAntiForgeryToken]
        public ActionResult DeleteConfirmed(int id)
        {
            CarModel carModel = db.Cars.Find(id);
            db.Cars.Remove(carModel);
            db.SaveChanges();
            return RedirectToAction("Index");
        }
        protected override void Dispose(bool disposing)
        {
            if (disposing)
            {
                db.Dispose();
            }
            base.Dispose(disposing);
        }
    }
}

@model EF_CodeFirstApproach.Models.CarModel
@{
    ViewBag.Title = "Szczegóły";
}
<h2>Szczegóły</h2>
<div style="border:1px solid rgb(128, 128, 128);padding:15px">
    <dl class="dl-horizontal">
        <dt>
            @Html.DisplayName("Marka: ")
        </dt>
        <dd>
            @Html.DisplayFor(model => model.Brand)
        </dd>
        <dt>
            @Html.DisplayName("Model: ")
        </dt>
        <dd>
            @Html.DisplayFor(model => model.Model)
        </dd>
    </dl>
</div>
<div style="border:1px solid rgb(128, 128, 128);padding:15px;margin-top:15px">
    <h4>Komentarze</h4>
    @if (Model.Comments.Count == 0)
    {
            <span>Brak komentarzy</span>
    }
    else
    {
        foreach (var item in Model.Comments)
        {
            <p>@item.Comment</p>
        }
    }
<br />
@* Link wskazuje na kontoler odpowiedzialny za dodawanie komentarzy do wskazanego samochodu *@
@* Przekazujemy CarId, aby wiedzieć dokładnie dla którego samochodu dodajemy komentarz *@
@Html.ActionLink("Dodaj nowy komentarz", "Create", "Comments", new { id = Model.CarId }, null)
</div>
<br />
<br />
<p>
    @Html.ActionLink("Edycja", "Edit", new { id = Model.CarId }) |
    @Html.ActionLink("Powrót do listy", "Index")
</p>

// Jako parametr przekazujemy CarId
public ActionResult Create(int id)
{
    // Pobieramz dane dotyczące wskazanego samochodu
    CarModel car = db.Cars.Single(a => a.CarId == id);
    // Tworzymy nowy obiekt komentarz
    CommentModel comm = new CommentModel();
    // Wypełniamy obiekt niezbędnymi informacjami
    comm.CarId = id;
    comm.Cars.Brand = car.Brand;
    comm.Cars.Model = car.Model;
    return View(comm);
}

@model EF_CodeFirstApproach.Models.CommentModel
@{
    ViewBag.Title = "Dodaj komentarz";
}
<h2>Dodaj komentarz</h2>
@using (Html.BeginForm())
{
    @Html.AntiForgeryToken()
    <div class="form-horizontal">
        <hr />
        @Html.ValidationSummary(true, "", new { @class = "text-danger" })
        @Html.HiddenFor(model => model.Id)
        @Html.HiddenFor(model => model.CarId, new { htmlAttributes = new { @class = "form-control" } })
      
        <div class="form-group">
            @Html.Label("Marka i model samochodu:", htmlAttributes: new { @class = "control-label col-md-2" })
            <div class="col-md-10">
            @{ 
                string car = Model.Cars.Brand + " " + Model.Cars.Model;
            }
            @Html.Label(car, new { htmlAttributes = new { @class = "form-control" } })
            </div>
        </div>
        <div class="form-group">
        @Html.Label("Komentarz", htmlAttributes: new { @class = "control-label col-md-2" })
            <div class="col-md-10">
                @Html.TextBoxFor(model => model.Comment, new { htmlAttributes = new { @class = "form-control" } })
                @Html.ValidationMessageFor(model => model.Comment, "", new { @class = "text-danger" })
            </div>
        </div>
        <div class="form-group">
            <div class="col-md-offset-2 col-md-10">
                <input type="submit" value="Zapisz" class="btn btn-default" />
            </div>
        </div>
    </div>
}
<div>
    @Html.ActionLink("Powrót to listy", "Index")
</div>
@section Scripts {
    @Scripts.Render("~/bundles/jqueryval")
}

// POST: CommentModels/Create
// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598.
[HttpPost]
[ValidateAntiForgeryToken]
public ActionResult Create([Bind(Include = "Id,CarId,Comment")] CommentModel commentModel)
{
    if (ModelState.IsValid)
    {
        db.Comments.Add(commentModel);
        db.SaveChanges();
        return RedirectToAction("Index");
    }
    ViewBag.CarId = new SelectList(db.Cars, "CarId", "Brand", commentModel.CarId);
    return View(commentModel);
}

Nasza prosta aplikacja zawierająca 2 encje w relacji 1 do wielu jest już gotowa. Użyliśmy podejścia projektowego, w którym zaczynamy pracę od napisania kodu a nie oparcia na istniejącej już bazie danych. Artykuł ten pokazuje jak używać takiego podejścia pisząc aplikacje webowe w technologii ASP.NET MVC.

Adnotacja: W powyższym przykładzie nie zostały użyte żadne wzorce takie jak, repozytorium czy jednostka pracy, ponieważ główną ideą artykułu było opisanie podejścia projektowego w jak najbardziej przystępny sposób. Dla doświadczonych programistów ten artykuł będzie bardzo prosty i niezbyt pomocny. Pamiętajcie jednak, że został napisany z perspektywy osoby początkującej.