把angular項目整合到.net mvc中

之前的開發選擇的是完全捨棄服務端，僅保留最簡單web伺服器提供angular經打包的靜態資源，此外所有的業務與數據請求都訪問一個分離的WebApi來實現。不過最近碰到一個需求，有必要使用多個客戶端，而各客戶端本身都是webpack打包出來的js而已，沒必要每個客戶端都自己建一個站點，這就有必要搭建一個服務端，根據參數動態渲染不同客戶端的腳本來服務多個客戶端了。主要需要解決兩個問題，一是防止前後端路由衝突各自有效工作，二是如何實現一套比較合理的部署方案。籠統一點看待這個問題，無非就是要實現如題目所描述的，如何將專註前端的強大框架(angular)整合到一個健壯的現有服務端(.Net)項目中去。

第一步必然是要先得到前端項目的打包資源，由強大的webpack來完成，目標是將angular的所有依賴以及應用主代碼分別打包到polyfill.js、vendor.js、main.js三個腳本中，以及非同步懶載入的模塊各自打包成一個chunk.js。webpack博大精深，剛接觸會摸不著頭腦，好在其終究是用來給我們帶來方便的一個工具而已，使用起來是很有條理的。其主要的介紹可以移步webpack的官方文檔【https://doc.webpack-china.org】，認真吸收完遠遠足夠寫出angular-webpack-starter【https://github.com/AngularClass/angular-starter】這樣完善的啟動項目來了。

簡單來說webpack配置有四部曲：

• 一、 定義入口文件 包含angular的依賴，angular框架代碼以及項目的啟動代碼即可，比如angular-webpack-starter中的配置：

entry: {
"polyfills": "./src/polyfills.browser.ts", // 依賴項
"main": AOT ? "./src/main.browser.aot.ts" : "./src/main.browser.ts" // 主程序
},

• 二、 定義打包規則

打包規則有好一些需要配置的，包括了各種文件類型的打包，angular模塊的打包等，配置方式見官方文檔或直接參照現成的啟動項目，直接看難免懵逼，但不要怕，規則其實就那麼點，眼熟就成功了大半。

• 三、配置插件

webpack有非常多的插件，用來強化打包能力以及規則的擴展，可以看看啟動項目中用到了哪些，這些插件在官方文檔里都能找到介紹。

• 四、 定義輸出規則

輸出要分生產環境和開發環境，本文只講生產環境。先明確webpack打包好的項目是要交給服務端使用的，給出的輸出要有幾個需求： 1) 轉義兼容瀏覽器和ES5並壓縮。2)輸出文件名附帶哈希值，代碼發生更改重新打包時要有不同的哈希值，保證此時替換的資源不會被瀏覽器緩存而得不到第一時間更新。3)列出資源打包清單，因為附帶了哈希值導致每次文件名都是很長一串奇怪字元，使用合適的webpack配置附帶一個manifest清單列出都輸出了哪幾個文件，進一步在使用時動態讀取其中的清單來操作輸出的文件。

順利的話開發完成的項目能得到類似下圖的打包資源：

其中webpack-assets.json中列出了三個依賴文件：

以0、1、2、3打頭的四個chunk文件是由angular動態引入的懶載入模塊，不需要手動引入自然也不需要列出來，只需要保證angular能訪問到它們即可。把這些東西全都放到一個.Net MVC項目中去：

然後在View視圖中引入三個腳本並配置base url：

現在運行MVC項目，定位到這個視圖可以順利渲染出angular項目來。問題在於手動輸入前端路由的url時，此url會被MVC路由視為404錯誤(因為MVC路由中確實未定義這一規則，真正使用此規則的angular客戶端還沒有機會解析這個url就被一個錯誤頁取代了)。

angular官方給出的指南是給服務端配置404的重定向，將所有的404錯誤都重定向到index.html，這樣前端就能順利開始解析輸入的url了。在MVC中做法也類似，只要在MVC的路由規則中，將必要路由(比如還定義了其他的Api或者錯誤頁)之外的所有請求都指向指定的Action，比如筆者的這條規則，將所有其他請求都指向AppController下的Index：

這樣除了/page/打頭的url外所有不滿足默認路由的請求都會定位到/App/Index。

使用MVC的View取代index.html

下一步是要在這個/App/Index中讀取前端打包生成的webpack-assets.json清單，將需要的文件渲染到視圖中，筆者項目添加了一個academyid來區分多客戶端，每個客戶端都有以自己id命名的一個資源目錄，實現如下圖所示：

筆者的C#比較摳腳，所以定義了一個class來解析json文件，然後才把解析到的文件名放到ViewData中以供前端使用。現在視圖中就可以使用Razer語法來渲染腳本依賴：

這樣子配置下來，服務端其實不需要再關心客戶端的更改，只關心從webpack-assets.json中解析要載入的依賴，並渲染這些依賴即可，每當客戶端代碼更改重新打包時，webpack-assets.json清單也會更新，毫不影響服務端。

總結

水平有限導致本文存在許多的不足之處，包括一直未涉及的SEO方案以及其他的隱藏問題，筆者還有很多需要學習完善的地方。

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！