Angularjs,WebAPI 搭建一个简易权限管理系统 —

6 Angularjs 前端主体结构

6.1 Angularjs目录结构

还记得上WebAPI项目主体结构（三）我们在"Yiim.web"，添加的"App" 目录吗？这一章节我们讲解一下 angularjs 目录结构。

App/images //存放系统使用的图标

App/styles //样式文件存储

App/scripts //是整个我们应用程序运行需要的文件

            /controllers //angularjs 控制器模块目录

            /directives //angularjs指令模块存放目录

            /filters  //过滤器模块存放目录

            /services //服务模块存放目录

            /app.js    //应用程序配置模块（路由配置）

App/vendor //项目依赖类库

            /angular //angular项目运行文件

            /bootstrap        //bootstrap文件

            .....

            ...

App/views //angularjs 视图模板存放页面

通过上面的我们把 angularjs的控制器，指令，过滤器等一系列模块的目录介绍完毕。

使用 Bootstrap 作为我们的 UI框架

6.2 Angularjs 与 Bootstrap 结合

Angularjs 只是一个前端脚本框架，并没有自己的UI 官方提供了一个 Angularjs 与 Bootstrap 结合的插件:

https://angular-ui.github.io/bootstrap/

GitHub地址:

https://github.com/angular-ui/bootstrap

我们只需要在bootstrap引用完毕后，再引用一条脚本即可。

https://angular-ui.github.io/bootstrap/ui-bootstrap-tpls-0.13.0.min.js

我们将此脚本保存到：

App/vendor/bootstrap/js 文件夹中

6.3 控制台页面配置

我们首先在项目 "Yiim.Web" 添加一个控制器 "ConsoleController"

在控制器中添加一个 Action "Index" 返回一个默认的视图

在项目文件"BundleConfig.cs" 我们添加一下脚本和配置

using System.Web;

using System.Web.Optimization;

namespace Yiim.Web

{

    public class BundleConfig

    {

        // For more information on Bundling, visit http://go.microsoft.com/fwlink/?LinkId=254725

        public static void RegisterBundles(BundleCollection bundles)

        {

            //清除忽略列表

            //http://stackoverflow.com/questions/11980458/bundler-not-including-min-files

            bundles.IgnoreList.Clear();

            //类库依赖文件

            bundles.Add(new ScriptBundle("~/js/base/library").Include(

                    "~/app/vendor/jquery-1.11.2.min.js",

                    "~/app/vendor/angular/angular.js",

                    "~/app/vendor/angular/angular-route.js",

                    "~/app/vendor/bootstrap/js/ui-bootstrap-tpls-0.13.0.min.js",

                    "~/app/vendor/bootstrap-notify/bootstrap-notify.min.js"

                   ));

            //angularjs 项目文件

            bundles.Add(new ScriptBundle("~/js/angularjs/app").Include(

                    "~/app/scripts/services/*.js",

                    "~/app/scripts/controllers/*.js",

                    "~/app/scripts/directives/*.js",

                    "~/app/scripts/filters/*.js",

                    "~/app/scripts/app.js"));

            //样式

            bundles.Add(new StyleBundle("~/js/base/style").Include(

                    "~/app/vendor/bootstrap/css/bootstrap.min.css",

                    "~/app/styles/dashboard.css",

                    "~/app/styles/console.css"

                    ));

        }

    }

}

注意代码：

在“View/Console/Index.cshtml”

文件我们添加配置内的文件的合并引用

<!DOCTYPE html>

<html ng-app="Yiim">

<head>

    <meta name="viewport" content="width=device-width" />

    <title>@ViewData["WebTitle"]</title>

    @Styles.Render("~/js/base/style")

    @Scripts.Render("~/js/base/library")

</head>

<body>

    @Scripts.Render("~/js/angularjs/app")

</body>

</html>

最终在浏览器端输出的内容为

<!DOCTYPE html>

<html ng-app="Yiim">

<head>

    <meta name="viewport" content="width=device-width" />

    <title>Yiim 简易权限管理系统</title>

    <link href="/app/vendor/bootstrap/css/bootstrap.min.css" rel="stylesheet"/>

    <link href="/app/styles/dashboard.css" rel="stylesheet"/>

    <link href="/app/styles/console.css" rel="stylesheet"/>

    <script src="/app/vendor/jquery-1.11.2.min.js"></script>

    <script src="/app/vendor/angular/angular.min.js"></script>

    <script src="/app/vendor/angular/angular-route.min.js"></script>

    <script src="/app/vendor/bootstrap/js/ui-bootstrap-tpls-0.13.0.min.js"></script>

    <script src="/app/vendor/bootstrap-notify/bootstrap-notify.min.js"></script>

</head>

<body>

    <script src="/app/scripts/app.js"></script>

</body>

</html>

除了bootstrap的样式我们还添加了"dashboard.css" 控制面板的样式和用于覆盖bootstrap的样式"console.css"。

我们在项目开始的时候没有添加如何的指令，控制器... 所以

 @Scripts.Render("~/js/angularjs/app")

只输出了

 <script src="/app/scripts/app.js"></script>

6.5 服务端路由配置

路由设置包含两个部分 WebAPI路由和 MVC路由

WebAPI路由:

默认Web API中没有对Action名称的匹配，因为默认的Action就是匹配的http协议内的动作“GET”,"POST","DELETE","PUT"，例如：

POST /api/user/

匹配的是"UserController",内的"Post"方法。

所以我们需要对API做如下的修改,这些修改时有必要的.如果真正的使用这些动作名称来区分控制,那我们的控制器也只能有这些Action了，所以我们做一下修改。

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web.Http;

namespace Yiim.Web

{

    public static class WebApiConfig

    {

        public static void Register(HttpConfiguration config)

        {

            config.Routes.MapHttpRoute(

                "APIDefault", //路由名称

                "api/{controller}/{action}/{id}", //添加对action的引用

                new

                {

                    id = RouteParameter.Optional

                });

        }

    }

}

MVC路由设置:

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Mvc;

using System.Web.Routing;

namespace Yiim.Web

{

    public class RouteConfig

    {

        public static void RegisterRoutes(RouteCollection routes)

        {

            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

            routes.MapRoute("Views", "{dir}-{name}", new { controller = "Utils", action = "Html" });

            routes.MapRoute("Default", "{controller}/{action}/{id}",

            new { controller = "Console", action = "Index", id = UrlParameter.Optional });

        }

    }

}

除了对默认路由的修改，我们还添加如下对 angularjs 视图文件输出的路由

routes.MapRoute("Views", "{dir}-{name}", new { controller = "Utils", action = "Html" });

并在控制器文件夹中添加一个名称为 "UtilsController"

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Mvc;

namespace Yiim.Web.Controllers

{

    public class UtilsController : Controller

    {

        public ActionResult Html(string dir, string name)

        {

            string html = string.Format("~/App/views/{0}/{1}.html", dir, name);

            if (!System.IO.File.Exists(Server.MapPath(html)))

                return Content(string.Format("当前请求的页面“{0}”不存在！", html));

            return File(html, "text/html; charset=utf-8");

        }

    }

}

上面做出的修改，针对 Angularjs 视图进行输出.

如果视图真实的路径为:

~/App/views/users/list.html

那么访问路径就可以这样访问

~/users-list;

这样做的好处是

前端引用视图的时候路径将会更加短小。
服务端可以对视图进行其控制

当然现在仅仅只是输出。我们完全可以把这个地方当成一个扩展点。

好了我们的项目骨架基本介绍到这里。