[Angularjs]asp.net mvc+angularjs+web api單頁應用

寫在前面

最近的工作一直在弄一些h5的單頁應用，然后嵌入到app的webview中。之前一直在用angularjs+html+ashx的一套東西。實在是玩膩了。然后就嘗試通過asp.net mvc的方式構建單頁應用。用到的技術angularjs+webapi+mvc。在網上找到了一些相關的文章，關於anguar的位置也沒有一個比較好的一個標准。這里也是拋磚引玉，希望通過討論，得到一個更好的結構。

項目結構

結構說明：

_Layout.cshtml:該文件作為模板文件，這里將應用的js，及css文件，都凡在該頁。如圖所示：

Controllers/api文件夾：存放webapi接口。

Controllers/*.cs：存放控制器。

將angularjs的mvc結構，都存放在了Scripts文件夾，這樣做，也是為了操作方便（文件多的話，來回的切換窗口，確實很麻煩）。

Scripts/App：存放angularjs的文件，以及app.js

app.js的定義如下，包括module的注冊，以及服務信息：

var app = angular.module('app_store', ['ngRoute', 'StoreService', ]);

//服務
var StoreService = angular.module('StoreService', []);
//請求服務
StoreService.factory('requestService', function ($http, $q) {
    var request = {
        method: 'POST',
        url: '',
        headers: { 'Content-Type': 'application/json' },
        data: {}
    };
    var postData = {
        lists: function (type) {
            request.method = "get";
            request.url = "../api/order/lists/" + type + "";
            return requestService($http, $q, request);
        },
        submit_product: function (data) {
            request.method = "post";
            request.url = "../api/order";
            request.data = data;
            return requestService($http, $q, request);
        }
    };
    return postData;
});
function requestService($http, $q, request) {
    var deferred = $q.defer(); // 聲明延后執行，表示要去監控后面的執行  
    $http(request).
    success(function (data, status, headers, config) {
        deferred.resolve(data);  // 聲明執行成功，即http請求數據成功，可以返回數據了  
    }).
    error(function (data, status, headers, config) {

        deferred.reject(data);   // 聲明執行失敗，即服務器返回錯誤  
    });
    return deferred.promise;   // 返回承諾，這里並不是最終數據，而是訪問最終數據的API  
};

將modlue的定義放在了該js文件中，其中也包括請求的服務，考慮到減少一次靜態文件的請求，所以將服務也放在了該文件中。

Scripts/Controllers：這是angularjs的控制器。用來定義前端的controller。關於這個你可以根據用途，分成不同的控制器。也可以對應於web api的方式定義。我建議如果功能不是太多，還是放在一個里面，如果定義太多的js文件，一是靜態文件的請求次數會很多，二是開發起來確實很頭大，每次開發在vs打開n個tab頁面，你會發現會讓你非常的頭大。

Scripts/Filter：存放angularjs自定義的過濾器，（如果過濾器不多，建議還是合並到app.js文件中。）

Scripts/Route：angularjs路由，如果路由不多，仍建議放在app.js中。

Scripts/Views：angularjs視圖，存放視圖模板。這個分法，不好說，可以參考asp.net mvc的分發，按控制器名稱建文件夾。如果視圖不多，我是一股腦的都塞到views文件夾了。

一個例子

列舉一個根據關鍵字搜索商品的列表的例子。

Scripts/Controllers/StoreController.js

app.controller('StoreController', function ($scope, $http, $location, $routeParams, requestService) {
    console.log('StoreController');
    if (!$scope.productKey) {
        $scope.productKey = "飛機";
    };
    requestService.lists($scope.productKey).then(function (data) {
        console.log(data);
        if (data._code === 200) {
            $scope.orders = data._data;
        };
    });
});

Scripts/Route/app-route.js

app.config(['$routeProvider', function ($routeProvider) {
    $routeProvider
    .when('/', { templateUrl: '../Scripts/Views/OrderList.html', controller: 'StoreController' })
    .when('/error', { templateUrl: '../Scripts/Views/Error.html', controller: 'ErrorController' })
    .otherwise({ redirectTo: '/error' });
}]);

Scripts/Views/OrderList.html

<div class="address_serace">
    <input class="form-control" ng-change="" ng-model="productKey" placeholder="搜索商品">
</div>
<div class="address_div">
    <dl class="address_dl" ng-repeat="item in orders">
        <dt class="address_checkbox">
            <img class="address_check" src="../Images/[e-mail]" />
        </dt>
        <dt class="address_user"><img class="address_user" src="../Images/dingy.png" /></dt>
        <dd class="address_font">
            <p class="address_font_t">{{item.Name}}</p>
            <p>單價：{{item.Price}}</p>
        </dd>
    </dl>

</div>

asp.net mvc 控制器StoreController.cs 中Index的action添加視圖，作為呈現的頁面。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;

namespace Wolfy.MvsSinglePage.Controllers
{
    public class StoreController : Controller
    {
        // GET: Store
        public ActionResult Index()
        {
            return View();
        }
    }
}

Index.cshtml,很簡單，一個添加指定ng-view的div，用來呈現Views中的html模板的。

@{
    ViewBag.Title = "Index";
}

<div ng-view></div>

web api:OrderController

using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;
using System.Web.Http;
using Wolfy.MvsSinglePage.Models;

namespace Wolfy.MvsSinglePage.Controllers.api
{
    public class OrderController : ApiController
    {
        // GET: api/Order
        [HttpGet]
        [Route("api/order/lists/{key?}")]
        public async Task<HttpResponseMessage> Get(string key)
        {
            return await Task.Run(() =>
            {
                HttpResponseMessage response = new HttpResponseMessage(HttpStatusCode.Accepted);
                List<Order> lst = new List<Order>() { 
                   new Order(){ Id=Guid.NewGuid(), Dt=DateTime.Now, Name="飛機", Price=2222222},
                   new Order(){ Id=Guid.NewGuid(), Dt=DateTime.Now, Name="飛機2", Price=2222222},
                   new Order(){ Id=Guid.NewGuid(), Dt=DateTime.Now, Name="飛機3", Price=2222222},
                   new Order(){ Id=Guid.NewGuid(), Dt=DateTime.Now, Name="飛機4", Price=2222222},
                   new Order(){ Id=Guid.NewGuid(), Dt=DateTime.Now, Name="飛機5", Price=2222222},
                   new Order(){ Id=Guid.NewGuid(), Dt=DateTime.Now, Name="飛機6", Price=2222222},
                };
                var results = string.IsNullOrEmpty(key) ? lst : lst.Where(x => x.Name.Contains(key));
                response = new HttpResponseMessage(HttpStatusCode.OK)
                {
                    Content = new StringContent(JsonConvert.SerializeObject(new { _code = 200, _data = results }))
                };
                return response;
            });
        }
    }
}

最后不要忘了，為_Layout.cshtml的html標簽添加指令ng-app。

運行測試：

總結

這是在實際工作中，摸索出的一種分層的方式，如果你有更好的建議，可以分享一下，在網上也找了一些資料，並沒有具體的分層方式。我這里拋磚引玉，希望有個更好的方案。

Demo Url: https://git.oschina.net/wolfy/Wolfy.Angularjs_Mvc_SPA