初識(shí)ASP.NET Mvc5+EF7的奇妙之旅

更新時(shí)間：2022年05月05日 11:00:12 投稿：lijiao

這篇文章主要和大家一起感受ASP.NET Mvc5+EF7的奇妙之旅，從旅程中認(rèn)識(shí)了解.NET5框架，感興趣的小伙伴們可以參考一下

話說(shuō)今年微軟是很給力的，Win10算是吸引了大眾的眼球了，而最新的.NET5框架更是OK。

最新的.NET5進(jìn)行了開源，同時(shí)利用NuGet以及Node和Bower進(jìn)行了跨平臺(tái)化；這意味這可以直接在Mac或者Linux上使用.NET進(jìn)行開發(fā)。

而最新的Mvc5和EF框架也算是進(jìn)行了換臉了，跟之前Mvc4的項(xiàng)目都不一樣，如果進(jìn)行移植除了核心代碼可以拷貝過(guò)來(lái)，其他的統(tǒng)統(tǒng)要重新來(lái)過(guò)。

最近準(zhǔn)備改版一下網(wǎng)站，所以嘗試了一把最新的框架；當(dāng)然由于現(xiàn)在還是預(yù)覽版所以改動(dòng)什么的都超大，所以也走了不少?gòu)澛?；特在此記錄一下?/p>

項(xiàng)目準(zhǔn)備

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

Mvc5 VS 插件：最新的預(yù)覽版為Beta7 下載地址

由于是Beta7，而微軟官方的說(shuō)明文檔和例子大部分可以適用，但是有些地方也是不對(duì)的，比如EF的命令，EF Beta3 與 Beta7差別很大，這也就是預(yù)覽版的缺點(diǎn)，時(shí)不時(shí)的就改動(dòng)了。
另外我這里使用的是VS2015而非Visual Studio Code ，畢竟有好點(diǎn)的肯定就用好的啊。

開工

新建項(xiàng)目

打開VS，點(diǎn)擊文件-新建-項(xiàng)目-Web

這里起名叫做：MusicBank，就是一個(gè)音樂(lè)店吧。

在這里我們來(lái)一個(gè)空的就好。我們來(lái)自己建立Model/EF….
OK，項(xiàng)目建立好了后，我們看見(jiàn)的是這樣的。

可以看見(jiàn)我們的項(xiàng)目其實(shí)是在 Src 文件夾下面。而項(xiàng)目中除了引用+簡(jiǎn)單設(shè)置以外就沒(méi)有任何東西。

環(huán)境搭配

項(xiàng)目有了，但是卻并不能直接用，我們需要搭建環(huán)境，比如我們需要引入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"
 },

在這里添加了對(duì)Mvc、EF、Configuration的依賴。
Mvc的作用主要用于控制器的解析等操作，包括了WebAPI。
EF當(dāng)然就是數(shù)據(jù)庫(kù)了。
Configuration 用來(lái)讀取本地配置，方便設(shè)置。

commands

打開文件“project.json” 我們修改commands部分為：

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

commands模塊的主要作用是命令行執(zhí)行，可簡(jiǎn)化操作，比如實(shí)際執(zhí)行時(shí)輸入 “ef” 即可代表 “EntityFramework.Commands”。

Model

OK，在這里我們先建立文件夾 Models，隨后我們?cè)贛odel文件夾上右鍵-添加-類:

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

一個(gè)歌唱家，有個(gè)名字和年齡，然后有N個(gè)歌曲。

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

歌曲也簡(jiǎn)化了，一個(gè)名字，一個(gè)類型，一個(gè)源文件，屬于某個(gè)歌唱家。

MusicContext

這個(gè)想必大家不陌生吧，用于數(shù)據(jù)庫(kù)的查詢等操作就全靠這個(gè)了；算是EF的精髓。

using Microsoft.Data.Entity;

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

這里只需要添加兩個(gè)表就OK。

SampleData

為了方便，這里我直接在創(chuàng)建數(shù)據(jù)庫(kù)的時(shí)候就進(jìn)行數(shù)據(jù)的初始化工作，添加一些默認(rèn)數(shù)據(jù)。

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

首先這是一個(gè)靜態(tài)方法，需要傳入一個(gè)“IServiceProvider”，這個(gè)可以在項(xiàng)目啟動(dòng)的時(shí)候調(diào)用。

在方法進(jìn)入后我們獲取到上面的“MusicContext”，然后我們進(jìn)行數(shù)據(jù)庫(kù)創(chuàng)建與數(shù)據(jù)添加工作。

if (context.Database.EnsureCreated())

這句主要用于判斷是否需要進(jìn)行數(shù)據(jù)庫(kù)創(chuàng)建，如果是將進(jìn)行創(chuàng)建，同時(shí)返回true，而后我們判斷是否具有數(shù)據(jù)，如果數(shù)據(jù)庫(kù)表為空，那么我們添加一些默認(rèn)數(shù)據(jù)。

配置文件 config.json

在項(xiàng)目根目錄添加文件：“config.json”在其中配置數(shù)據(jù)庫(kù)鏈接字段如下：

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

啟動(dòng)配置Startup.cs

在項(xiàng)目啟動(dòng)的時(shí)候?qū)?huì)調(diào)用 Startup.cs 中的相關(guān)方法進(jìn)行數(shù)據(jù)的初始化操作。

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

獲取到配置config.json，在構(gòu)造函數(shù)中完成
設(shè)置數(shù)據(jù)庫(kù)文件連接，在ConfigureServices方法中完成
初始化數(shù)據(jù)庫(kù)相關(guān)數(shù)據(jù)，在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);
  }
 }
}

到這里我們的初始化操作基本完成了，現(xiàn)在來(lái)看看如何訪問(wèn)數(shù)據(jù)庫(kù)數(shù)據(jù)了。

Controllers

首先在根目錄添加文件夾 Controllers，右鍵-添加-新建項(xiàng)

在這里我就使用一個(gè)簡(jiǎn)單的WebAPI來(lái)進(jìn)行數(shù)據(jù)演示了，后面會(huì)在文章中詳細(xì)寫寫數(shù)據(jù)的渲染相關(guān)。

在文件 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;
  }
 }
}

一個(gè)屬性，兩個(gè)方法。

在這里我們可以看見(jiàn) MusicContext 屬性并沒(méi)有初始化，但是下面卻能直接調(diào)用；這是因?yàn)槲覀兲砑恿艘粋€(gè)屬性“[FromServices]”，該屬性意味著服務(wù)器能自動(dòng)采用注解的方式對(duì) db 進(jìn)行賦值。

下面兩個(gè)方法分別返回全部的音樂(lè)列表，和根據(jù)音樂(lè)名稱返回音樂(lè)相關(guān)信息。

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

運(yùn)行

在這里運(yùn)行方式有兩種，分別是 IIS 與 Web 命令行的方式。

IIS

這種方式直接運(yùn)行，VS將打開瀏覽器并設(shè)置端口。

Web

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

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

在這里我們啟動(dòng)時(shí)候的參數(shù)在“hosting.ini”文件中，我們打開 hosting.ini 文件。

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

可以找到我們?cè)L問(wèn)的Url，運(yùn)行后把Url拷貝到瀏覽器運(yùn)行就OK。
運(yùn)行情況下你會(huì)看見(jiàn)這樣的窗口，可以看出其實(shí)是調(diào)用的dnx進(jìn)行運(yùn)行的程序。而 DNX 是可以跨平臺(tái)的，這也就意味著可以直接在Mac上跑起來(lái)。

效果