如何在Mvc 6 中創建 Web Api以及如何脫離IIS實現自我托管

   微軟推出的Asp.net vNext（asp.net 5.0）的其中的一個目標就是統一mvc 和web api 的框架。接下來我就演示一下一下幾個內容

 1，怎么在Asp.net mvc 6 中創建簡單的web api。

 2，怎么在空的項目工程中添加程序需要的組件。

 3，怎么去配置Asp.net 5.0 管道。

 4，怎么不通過IIS自我托管。

首先需要安裝Visual Studio 2015 Preview，安裝完之后，打開File >New >Project 然后 Template>C#>Web 新建一個Asp.Net Web Application 我命名為WebApiDemo：之后要選擇 Asp.net 5 Empty 然后選擇ok 就可以了 ：

 

 

項目包括如下幾個文件：

 

• global.json 是包括整個solution的設置並且可以確保項目和項目之間的引用。
• project.json 是這個工程的配置。
• Startup.cs 是 startup 和 配置的代碼。

 

在Startup.cs 中配置asp.net 的請求管道，

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        // Nothing here!
    }
}

如果現在運行項目會發現什么也沒有，那我們就先簡單的添加一個歡迎頁面，打開project.json 文件，這個文件可以配置我們這個程序的一些設置

{
    "webroot": "wwwroot",
    "version": "1.0.0-*",
    "exclude": [
        "wwwroot"
    ],
    "packExclude": [
        "**.kproj",
        "**.user",
        "**.vspscc"
    ],
    "dependencies": {
        "Microsoft.AspNet.Server.IIS": "1.0.0-beta1"
    },
    "frameworks" : {
        "aspnet50" : { },
        "aspnetcore50" : { }
    }
}

其中 "dependencies" 是一些Nuget 包和類庫。我們先添加一個 Microsoft.AspNet.Diagnostics 。添加的時候會有只能提示。

 

 

"dependencies": {
"Microsoft.AspNet.Server.IIS": "1.0.0-beta1",
"Microsoft.AspNet.Diagnostics": "1.0.0-beta1"
},

然后再Startup.cs 中添加

 public class Startup
    {
        public void Configure(IApplicationBuilder app)
        {
            // For more information on how to configure your application, visit http://go.microsoft.com/fwlink/?LinkID=398940

            app.UseWelcomePage();
        }
    }

然后f5 運行 效果就出來了：

 

 簡單的創建了一個頁面，接下來我們就進入正題，創建web api。

同樣我們需要在project.json 中添加mvc 6的包

  "dependencies": {
        "Microsoft.AspNet.Server.IIS": "1.0.0-beta1",
        "Microsoft.AspNet.Diagnostics": "1.0.0-beta1",
        "Microsoft.AspNet.Mvc": "6.0.0-beta1"
    },

接下來添加mvc 的請求管道在startup.cs 中

 先引用 Microsoft.Framework.DependencyInjection，

然后添加如下方法：

 public void ConfigureServices(IServiceCollection services)
 {
    
  services.AddMvc();
  }

注意方法名不要錯了，在程序啟動的時候 mvc 框架會自動運行這個方法。

然后在 Startup.cs 的configure方法中添加代碼： app.UseMvc();

 然后新建一個Models文件夾 里面新建一個類Test

    public class Test
    {
        public int Id { get; set; }
        [Required]
        public string Title { get; set; }
    }

同樣新建一個文件夾Controller 然后新建一個HomeController 的Wep Api 的 controller。

 

namespace WebApiDemo.Controllers.Controllers
{
    //注意這個寫法，web api 的路由 不要忘了前面的api當然你可以隨意的命名 
    [Route("api/[controller]")]
    public class HomeController : Controller
    {

        public static List<Test> list = new List<Test>() {
              new Test() { Id=1, Title="test1" },
              new Test() { Id=2, Title="test2" }
        };



        // GET: api/values
        //獲得所有數據 
        [HttpGet]
        public IEnumerable<Test> Get()
        {
            return list;
        }

       //按照id 查找數據 其中HttpGet 中 {id} 是模板 Name是路由的名字在mvc 5中的api 中HttpGet 是沒有參數的。
        // GET api/values/5
        [HttpGet("{id}", Name = "getbyid")]
        public IActionResult Get(int id)
        {
            var item = list.FirstOrDefault(p => p.Id.Equals(id));

            if (item == null)
            {
                return HttpNotFound();
            }

            return new ObjectResult(item);

        }

        // POST api/values
       //添加數據
        [HttpPost]
        public void Post([FromBody]Test value)
        {
            if (!ModelState.IsValid)
            {
                Context.Response.StatusCode = 400;
            }
            else
            {
                value.Id = list.Max(p => p.Id) + 1;
                list.Add(value);

                string url = Url.RouteUrl("getbyid", new { id = value.Id });

                Context.Response.StatusCode = 201;
               //添加成功之后，跳轉看是否添加成功
                Context.Response.Headers["Location"] = url;
            }


        }

        //更新數據
        // PUT api/values/5
        [HttpPut("{id}")]
        public IActionResult Put(int id, [FromBody]Test value)
        {
            if (!ModelState.IsValid)
            {
                return new HttpStatusCodeResult(500);
            }
            else
            {
                var item = list.FirstOrDefault(p => p.Id.Equals(id));

                if (item == null)
                {
                    return HttpNotFound();
                }
                else
                {

                    value.Id = item.Id;

                    list.Remove(item);
                    list.Add(value);

                    return new ObjectResult(value);
                }

            }
        }
        
        //刪除數據
        // DELETE api/values/5
        [HttpDelete("{id}")]
        public IActionResult Delete(int id)
        {

            var item = list.FirstOrDefault(x => x.Id == id);
            if (item == null)
            {
                return HttpNotFound();
            }
            list.Remove(item);
            return new HttpStatusCodeResult(204); 
        }
    }
}

該注釋的我已經注釋了。ok 看看效果：

我們發現每次f5 運行項目的時候都要通過運行IIS Express 我們才能運行我們的程序，那么有沒有可能不通過IIS也能運行我們的程序呢？對於asp.net 5.0 來說答案是肯定的。 我們看一下是怎么做的？ asp.net 5.0 可以托管到多種的web server 上 ，這里選擇WebListener。即我們可以通過控制台來托管我們程序。

首先在 project.json 中添加Microsoft.AspNet.Server.WebListener包。另外還需要新加一個 "commands" 的設置完整的內容如下：

{
    "webroot": "wwwroot",
    "version": "1.0.0-*",
    "exclude": [
        "wwwroot"
    ],
    "packExclude": [
        "**.kproj",
        "**.user",
        "**.vspscc"
    ],
    "dependencies": {
        "Microsoft.AspNet.Server.IIS": "1.0.0-beta1",
        "Microsoft.AspNet.Diagnostics": "1.0.0-beta1",
        "Microsoft.AspNet.Mvc": "6.0.0-beta1",
        "Microsoft.AspNet.Server.WebListener": "1.0.0-beta1"
    },
    "frameworks": {
        "aspnet50": { },
        "aspnetcore50": { }
    },
    "commands": {
        "web": "Microsoft.AspNet.Hosting --server Microsoft.AspNet.Server.WebListener --server.urls http://localhost:5000"
    }

}

然后右鍵項目屬性的debug 選項 設置debug target 為web

 

然后F5運行：

這樣程序就托管成功了。打開瀏覽器輸入地址：

 

Ok成功了。關於asp.net 5.0 的一些新特性我還在研究，以后我還會發布相關的文章。Asp.net 5.0 這次的變動真的非常的讓人激動。