初探ASP.NET Mvc5+EF7的美妙旅程
序
話說今年微軟是很給力的，Win10算是吸引了大眾的眼球了，而最新的.NET5框架更是OK。
最新的.NET5進行了開源，同時利用NuGet以及Node和Bower進行了跨平臺化；這意味這可以直接在Mac或者Linux上使用.NET進行開發。
而最新的Mvc5和EF框架也算是進行了換臉了，跟之前Mvc4的專案都不一樣，如果進行移植除了核心程式碼可以拷貝過來，其他的統統要重新來過。
最近準備改版一下網站，所以嘗試了一把最新的框架；當然由於現在還是預覽版所以改動什麼的都超大，所以也走了不少彎路；特在此記錄一下。
專案準備
由於是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" 在這裡添加了對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.WebListener
server.urls=http://localhost:5000可以找到我們訪問的Url，執行後把Url拷貝到瀏覽器執行就OK。
執行情況下你會看見這樣的視窗，可以看出其實是呼叫的dnx進行執行的程式。而 DNX 是可以跨平臺的，這也就意味著可以直接在Mac上跑起來。
效果
可以看出兩個方法的介面呼叫結果是OK的。
程式碼
專案完成了，程式碼也進行了打包；具體地址在這兒：
MusicBank
========================================================