ASP.NET入門(1) - 建立和開發ASP.NET 5 項目
ASP.NET 5 了解和入門
使用自定義配置檔案
建立項目
首先,目前隻有VS 2015支援開發最新的ASP.NET 5 程式,是以我們首先需要下載下傳安裝其最新的RC版本.
https://www.visualstudio.com/en-us/downloads/visual-studio-2015-downloads-vs.aspx
安裝完畢以後,打開并建立新的Web Application項目:
然後在後一個界面中選擇ASP.NET 5 Empty模闆:
這裡提2個注意點:
- 要選擇下面的ASP.NET 5模闆,而不是上面的4.6模闆.
- 選擇Empty模闆而不是後面更完整的Web Site模闆是希望能夠從無到有,逐漸分解這個最新的架構體系.
建立項目完成以後,我們可以看到如下項目結構:
其中global.json記錄了解決方案的一些配置,Project_Readme.html則是一個介紹頁面.
比較重要的檔案或者檔案夾是以下3個:
l Startup.cs : 啟動類
l project.json: 項目配置檔案
l wwwroot : 整個WebApp的靜态檔案目錄(由于最小模闆沒有加載靜态檔案中間件,是以該目錄内容暫時無效,這個稍後說明)
啟動類
ASP.NET 5的啟動類隻有一個，這裡再也沒有Global.asax，RouteConfig等耳熟能詳的啟動檔案，而隻剩下這個Startup.cs是ASP.NET 5的唯一入口。
一般情況下Startup類會包含3個主要函數: 構造函數，ConfigureServices和Configure
在最小模闆下,我們僅僅看到後面2個函數,沒有構造函數,雖然不是必須的,但構造函數在讀取初始化參數的環境下也是非常重要的,這個我們以後再介紹.
我們可以這樣來了解這3個函數的作用:
構造函數: 加載各種配置檔案和配置資訊.
ConfigureServices: 加載各種基于依賴注入(Dependency Injection)的服務,這裡提下,在ASP.NET 5中,依賴注入技術得到了充分的使用,大大優化了代碼的結構.
Configure: 加載各種需要的中間件(Middleware),這個概念和Owin中間件概念是一緻的,和原來IIS中的HttpModule非常的類似.
配置檔案
ASP.NET 5 内置标準的Config檔案隻有一個: project.json. 其他配置檔案都是自定義并自行裝載的。當然，在Solution目錄有一個global.json檔案，但這個和ASP.NET 5主體項目關系不大。另外在project.json之下，還隐藏了一個project.lock.json,其本質内容是記載了大量.NET運作環境(DNX)内置的元件資訊，這個檔案是由VS自行管理的，是以這個檔案我們目前也先略過。
關于.NET運作環境(DNX)是VS 2015以後為适應多平台運作環境所提出的全新的概念,這個概念對了解ASP.NET編譯和運作環境至關重要,不過此内容不在本文的讨論範圍以内,如果要深入了解,請通過我上一篇博文ASP.NET 5 (vNext) 了解和概述 中提供的超鍊來進一步學習.
那麼我們開始進入project.json
"webroot": "wwwroot",
"version": "1.0.0-*",
前者定義了WebApp靜态檔案的根目錄,一般不需要修改;後者定義了整個項目的版本号.
"dependencies": {
"Microsoft.AspNet.Server.IIS": "1.0.0-beta4",
"Microsoft.AspNet.Server.WebListener": "1.0.0-beta4"
},
除了.Net運作環境DNX内置元件外,項目所需加載的外部元件,目前隻有2個Server元件: IIS和控制台,這2個元件可以讓目前的WebApp運作在IIS或者控制台程式.
這裡稍微提下,可以通過這個配置段落的智能感覺快速的給目前項目加入元件,這個牛逼的特性我們下面詳細介紹.
"commands": {
"web": "Microsoft.AspNet.Hosting --server Microsoft.AspNet.Server.WebListener --server.urls http://localhost:5000"
這裡定義項目内部内置的各種指令,由于控制台Server模式必須由一個指令啟動,是以在此定義了一個web指令行.通過啟動這個指令就能啟動控制台Server模式.一般來說,VS提供了啟動這個指令内在機制,但我們要了解,ASP.NET其實是通過DNX環境的核心指令dnx.exe來運作外部指令的,關于這個指令我感覺目前整合的并不完美,而且這個指令存在于一個非常詭異的地方,關于這部分内容我們再後面的博文在進一步讨論.
"frameworks": {
"dnx451": { },
"dnxcore50": { }
定義該項目可以運作的.Net Framework版本,預設同時支援4.5.1和5.0 Core版本,去掉任何一個都是可以的,當然要注意5.0還沒有最終Release,還需要注意有些元件可能在5.0 Core版本上會有相容問題,這個時候就必須進行取舍.
"publishExclude" 和 "exclude"主要影響釋出和編譯時的内容選擇.對主功能影響不大.
第一次運作
好,下面我們來運作下看看是什麼效果,選擇web方式(控制台Server)運作,會彈出一個控制台程式:
然後用浏覽器通路http://localhost:5000 (這個URL和project.json中web command的參數配置相吻合),可以看到 一個有“Hello World”的頁面.
為什麼最小模闆下會有這個頁面,我們可以看到其實在Startup的Configure函數中有這樣一段代碼:
public void Configure(IApplicationBuilder app)
{
app.Run(async (context) =>
{
await context.Response.WriteAsync("Hello World!");
});
} 這裡用Lambda表達式實作了一個非常小型的中間件,當然這塊代碼沒有什麼特别意義,可以去除.
元件管理
正如我上一篇文章所有，ASP.NET 5的元件必需通過Nuget進行管理，但實際操作中，卻可以有2種方式。
通過Nuget安裝,這個用過VS2013的同學都應該非常熟悉了,當然VS2015界面略有不同,而且更加準确,功能更完整,大家具體看一下就了解了.
而我想特别推薦的是第二種方式,在project.json檔案的dependencies小節,直接使用智能感覺進行添加.
加載第一個中間件 - 靜态檔案StaticFile
當然首先我們要引入StaticFile元件,利用直接修改project.json的方式,可以進行快速的添加:
"Microsoft.AspNet.Server.WebListener": "1.0.0-beta4",
//Static Files
"Microsoft.AspNet.StaticFiles": "1.0.0-beta4"
修改并儲存之後,VS會自動把這個元件加載到目前項目的所有Framework中:
下面我們來加載靜态檔案的中間件,我們知道,所有中間件是通過Startup的Configure函數來加載的,我們把這個函數原有的代碼替換為如下代碼.
public void Configure(IApplicationBuilder app)
{
//加載靜态檔案中間件
app.UseStaticFiles();
} 根據前面的說明我們知道靜态檔案中間件會把根目錄預設設定為wwwroot,下面我們再這個目錄下建立一個index.html,裡面放入任何内容.
這時候再次啟動整個項目(web方式)通過http://localhost:5000/index.html 就可以通路到這個頁面. (反之,如果你沒有添加app.UseStaticFiles();這個頁面是通路不到的)
下面我們稍微擴充下,如果我們想把index.html設定為我們的預設文檔,我們應該如何去做,其實很簡單,在StaticFiles元件中,還提供了另外一個中間件來實作這個功能,我們回到Configure函數再加入如下代碼即可:
public void Configure(IApplicationBuilder app)
{
//設定靜态檔案的預設文檔
app.UseDefaultFiles(new DefaultFilesOptions()
{
DefaultFileNames = new string[] { "index.html" }
});
//加載靜态檔案中間件
app.UseStaticFiles();
} 這個時候需要引入
using Microsoft.AspNet.StaticFiles;
另外UserDefaultFIles必須在UserStaticFiles之前運作.
然後重新啟動項目,會發現直接通路 http://localhost:5000 就能看到index.html頁面.
當然StaticFiles中間件僅僅是一個起步,一個真正有意義的Web Application還需要更多的内容,下面我會依次介紹在ASP.NET 5項目中如何加入MVC 6, WebApi 2, Entity Framework 7, MS Identity 3的實作方法. 敬請期待.
軟體開發,項目管理,開發管理,團隊管理.
CMMI,PMP