初識ASP.NET Mvc5+EF7的奇妙之旅_實用技巧

話說今年微軟是很給力的，Win10算是吸引了福士的眼球了，而最新的.NET5架構更是OK。

最新的.NET5進行了開源，同時利用NuGet以及Node和Bower進行了跨平台化；這意味這可以直接在Mac或者Linux上使用.NET進行開發。

而最新的Mvc5和EF架構也算是進行了換臉了，跟之前Mvc4的項目都不一樣，如果進行移植除了核心代碼可以拷貝過來，其他的統統要重新來過。

最近準備改版一下網站，所以嘗試了一把最新的架構；當然由於現在還是預覽版所以改動什麼的都超大，所以也走了不少彎路；特在此記錄一下。

項目準備

工具：VS2015/Visual Studio Code 2015 下載地址

Mvc5 VS 外掛程式：最新的預覽版為Beta7 下載地址

由於是Beta7，而微軟官方的說明文檔和例子大部分可以適用，但是有些地方也是不對的，比如EF的命令，EF Beta3 與 Beta7差別很大，這也就是預覽版的缺點，時不時的就改動了。
另外我這裡使用的是VS2015而非Visual Studio Code ，畢竟有好點的肯定就用好的啊。
開工

建立項目

開啟VS，點擊檔案-建立-項目-Web

這裡起名叫做：MusicBank，就是一個音樂店吧。

在這裡我們來一個空的就好。我們來自己建立Model/EF….
OK，項目建立好了後，我們看見的是這樣的。

可以看見我們的項目其實是在 Src 檔案夾下面。而項目中除了引用+簡單設定以外就沒有任何東西。

環境搭配

項目有了，但是卻並不能直接用，我們需要搭建環境，比如我們需要引入EF等等。

dependencies

開啟檔案“project.json” 我們修改dependencies部分為：

 "dependencies": { "Microsoft.AspNet.Server.IIS": "1.0.0-beta7", "Microsoft.AspNet.Server.WebListener": "1.0.0-beta7", "Microsoft.AspNet.StaticFiles": "1.0.0-beta7", "Microsoft.AspNet.Mvc": "6.0.0-beta7", "EntityFramework.Commands": "7.0.0-beta7", "EntityFramework.SqlServer": "7.0.0-beta7", "Microsoft.Framework.Configuration.Json": "1.0.0-beta7", "Microsoft.Framework.Configuration.UserSecrets": "1.0.0-beta7" },

在這裡添加了對Mvc、EF、Configuration的依賴。
Mvc的作用主要用於控制器的解析等操作，包括了WebAPI。
EF當然就是資料庫了。
Configuration 用來讀取本地配置，方便設定。

commands

開啟檔案“project.json” 我們修改commands部分為：

 "commands": { "web": "Microsoft.AspNet.Hosting --config hosting.ini", "ef": "EntityFramework.Commands" },

commands模組的主要作用是命令列執行，可簡化操作，比如實際執行時輸入 “ef” 即可代表 “EntityFramework.Commands”。

Model

OK，在這裡我們先建立檔案夾 Models，隨後我們在Model檔案夾上右鍵-添加-類:

Artist

using System;using System.Collections.Generic;using System.ComponentModel.DataAnnotations;using System.ComponentModel.DataAnnotations.Schema;namespace MusicBank.Models{ public class Artist {  [Key]  [DatabaseGeneratedAttribute(DatabaseGeneratedOption.Identity)]  public Guid Id { get; set; }  [Required]  public string Name { get; set; }  [Required]  public int Age { get; set; }  public virtual List<Audio> Audio { get; set; } }}

一個歌唱家，有個名字和年齡，然後有N個歌曲。

Audio

using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace MusicBank.Models
{
    public class Audio
    {
        [Key]
        [DatabaseGeneratedAttribute(DatabaseGeneratedOption.Identity)]
        public Guid Id { get; set; }
        [Required]
        public string Name { get; set; }
        [Required]
        public int Type { get; set; }
        [Required]
        public string Src { get; set; }
        [Required]
        public Guid ArtistId { get; set; }
        public Artist Artist { get; set; }
    }
}
歌曲也簡化了，一個名字，一個類型，一個源檔案，屬於某個歌唱家。

MusicContext

這個想必大家不陌生吧，用於資料庫的查詢等操作就全靠這個了；算是EF的精髓。

using Microsoft.Data.Entity;namespace MusicBank.Models{ public class MusicContext : DbContext {  public DbSet<Audio> Audio { get; set; }  public DbSet<Artist> Artists { get; set; } }}

這裡只需要添加兩個表就OK。

SampleData

為了方便，這裡我直接在建立資料庫的時候就進行資料的初始化工作，添加一些預設資料。

using Microsoft.Framework.DependencyInjection;using System;using System.Linq;namespace MusicBank.Models{ public class SampleData {  public static void Initialize(IServiceProvider serviceProvider)  {   var context = serviceProvider.GetService<MusicContext>();   if (context.Database.EnsureCreated())   {    if (!context.Artists.Any())    {     var austen = context.Artists.Add(      new Artist { Name = "Austen", Age = 21 }).Entity;     var dickens = context.Artists.Add(      new Artist { Name = "Dickens", Age = 25 }).Entity;     var cervantes = context.Artists.Add(      new Artist { Name = "Cervantes", Age = 27 }).Entity;     context.Audio.AddRange(      new Audio()      {       Name = "Pride",       Type = 1,       Artist = austen,       Src = "Pride.mp3"      },      new Audio()      {       Name = "Northanger",       Type = 2,       Artist = austen,       Src = "Northanger.mp3"      },      new Audio()      {       Name = "David",       Type = 3,       Artist = dickens,       Src = "David.mp3"      },      new Audio()      {       Name = "DonQuixote",       Type = 1,       Artist = cervantes,       Src = "DonQuixote.mp3"      }     );     context.SaveChanges();    }   }  } }}

首先這是一個靜態方法，需要傳入一個“IServiceProvider”，這個可以在項目啟動的時候調用。

在方法進入後我們擷取到上面的“MusicContext”，然後我們進行資料庫建立與資料添加工作。

if (context.Database.EnsureCreated())

這句主要用於判斷是否需要進行資料庫建立，如果是將進行建立，同時返回true，而後我們判斷是否具有資料，如果資料庫表為空白，那麼我們添加一些預設資料。

設定檔 config.json

在項目根目錄添加檔案：“config.json”在其中設定資料庫連結欄位如下：

{ "Data": { "MusicConnection": {  "ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=MusicBank-Database;Trusted_Connection=True;MultipleActiveResultSets=true" } }}

啟動配置Startup.cs

在項目啟動的時候將會調用 Startup.cs 中的相關方法進行資料的初始化操作。

在這裡我們需要做三件事兒：

擷取到配置config.json，在建構函式中完成
設定資料庫檔案串連，在ConfigureServices方法中完成
初始化資料庫相關資料，在Configure方法中完成

using Microsoft.AspNet.Builder;using Microsoft.AspNet.Hosting;using Microsoft.Data.Entity;using Microsoft.Dnx.Runtime;using Microsoft.Framework.Configuration;using Microsoft.Framework.DependencyInjection;using MusicBank.Models;namespace MusicBank{ public class Startup {  public Startup(IHostingEnvironment env, IApplicationEnvironment appEnv)  {   var builder = new ConfigurationBuilder(appEnv.ApplicationBasePath)    .AddJsonFile("config.json")    .AddJsonFile($"config.{env.EnvironmentName}.json", optional: true);   builder.AddEnvironmentVariables();   Configuration = builder.Build();  }  public IConfigurationRoot Configuration { get; set; }  public void ConfigureServices(IServiceCollection services)  {   services.AddMvc();   services.AddEntityFramework()    .AddSqlServer()    .AddDbContext<MusicContext>(options =>    {     options.UseSqlServer(Configuration["Data:MusicConnection:ConnectionString"]);    });  }  public void Configure(IApplicationBuilder app, IHostingEnvironment env)  {   app.UseStaticFiles();   app.UseMvc();   SampleData.Initialize(app.ApplicationServices);  } }}

到這裡我們的初始化操作基本完成了，現在來看看如何訪問資料庫資料了。

Controllers

首先在根目錄添加檔案夾 Controllers，右鍵-添加-建立項

在這裡我就使用一個簡單的WebAPI來進行資料示範了，後面會在文章中詳細寫寫資料的渲染相關。

在檔案 AudioController.cs 中，我們更改代碼為：

using Microsoft.AspNet.Mvc;using MusicBank.Models;using System.Collections.Generic;using System.Linq;namespace MusicBank.Controllers{ [Route("api/[controller]")] public class AudioController : Controller {  [FromServices]  public MusicContext db { get; set; }  [HttpGet]  public IEnumerable<Audio> Get()  {   return db.Audio.ToList();  }  [HttpGet("{name}")]  public Audio Get(string name)  {   Audio audio = db.Audio.Where(a => (a.Name == name)).FirstOrDefault();   return audio;  } }}

一個屬性，兩個方法。

在這裡我們可以看見 MusicContext 屬性並沒有初始化，但是下面卻能直接調用；這是因為我們添加了一個屬性“[FromServices]”，該屬性意味著伺服器能自動採用註解的方式對 db 進行賦值。

下面兩個方法分別返回全部的音樂列表，和根據音樂名稱返迴音樂相關資訊。

當然在兩個方法上都有“[HttpGet]”屬性，該屬性指定了請求類型為 Get 方式，當然也有其他幾種，如：“HttpPost”“HttpPut”“HttpDelete”等。

運行

在這裡運行方式有兩種，分別是 IIS 與 Web 命令列的方式。

IIS

這種方式直接運行，VS將開啟瀏覽器並設定連接埠。

Web

還記得上面寫到命令列的地方嗎？其中有這樣一行：

 "web": "Microsoft.AspNet.Hosting --config hosting.ini",

在這裡我們啟動時候的參數在“hosting.ini”檔案中，我們開啟 hosting.ini 檔案。

server=Microsoft.AspNet.Server.WebListenerserver.urls=http://localhost:5000

可以找到我們訪問的Url，運行後把Url拷貝到瀏覽器運行就OK。
運行情況下你會看見這樣的視窗，可以看出其實是調用的dnx進行啟動並執行程式。而 DNX 是可以跨平台的，這也就意味著可以直接在Mac上跑起來。
這裡寫圖片描述

效果

可以看出兩個方法的介面調用結果是OK的。

初識ASP.NET Mvc5+EF7的旅程到這裡就結束了，希望可以為大家開啟ASP.NET Mvc5+EF7的又一個美妙旅程。