Angular简单应用剖析

　　这一篇我们将一起感受学习一个小型的、活生生的应用，而不是继续深入分析哪些单个的特性。我们将会一起感受一下，前面所讨论过的所有片段如何才能真正的组合在一起，形成一个真实的、可以运行的应用。

GutHub是一款菜谱管理应用。我们学习它有两个目的，第一是用它来管理美味的菜谱，第二是用它来学习angularjs的方方面面：

这款应用的特性如下：

a)         两列布局

b)         在左侧有一个导航栏

c)         允许你创建新菜谱

d)         允许你浏览现有的菜谱列表

主视图位于右侧，主视图将会根据具体的URL刷新，可惜显示菜谱列表、菜谱项目详情、以及用来添加或编辑菜谱的表单。

模型、控制器和模版（视图）之间的关系

这三种东西是如何协作的，应用应该用什么样的视角来看待它们。

模型就是真理。你的整个应用都是由模型驱动的——视图中所有展示的内容都是视图、被存储起来的内容是模型，几乎所有的内容都是模型。所以请把“模型就是真理”这句话多读几遍。同时花一点时间思考一下模型，思考一下对象中的属性应该是怎样的内容、应该如何从服务器端获取模型，以及如何保存它。通过视图绑定技术，视图会根据数据模型自动刷新，所以模型总是应用的焦点。

控制器将会负责业务逻辑：应该如何获取模型、可以在模型上执行何种操作、视图需要模型上的何种信息，如何如何转换模型以获取想要的信息。表单校验任务、对服务器调用、使用正确的数据启用视图，以及与此相关的几乎所有的事情都是控制器的职责。

最有，模版代表模型的展现形式，以及用户应该如何与应用进行交互。模版主要用来做一下事情：

n  展示模型

n  定义用户与应用之间的交互方式

n  给应用提供样式，并且判断何时以及怎样显示一些元素

n  过滤并格式化数据

视图是模版和模型融合之后产生的东西。模版中不应该包含任何业务逻辑和行为，只有控制器才能具备这些特性。但是你可能会问，DOM操作应该放到那里呢？DOM操作并不会发生在控制器或模版中。它由angular指令负责（有时候也可以通过服务进行操作，DOM操作放到放到服务中可以避免重复代码）。

模型

对于当前这款应用，我们将会让模型保持超级简单。这里的模型就是一些菜谱，它们将是真个应用的唯一的模型对象，其他所有的东西都是构建在模型之上。

每一天菜谱都具有一下特性：

• 一个ID，这个ID将会被持久化到服务器
• 一个名称
• 一个简短的描述
• 烹饪指南
• 是否是特色菜
• 配料数组，每一项都包含重量、单位及名称

就这么多，超级简单，应用中所有的东西都围绕这个简单的模型而构建，下面是一天简单的菜谱：

 {
   "id":"1",
   "title":"热姜汁藕片",
   "description":"藕片切得越薄越容易入味。",
   "ingredients":[
     {
       "amount":"450",
       "amountUnits":"g",
       "ingredientName":"姜"
     },
     {
       "amount":"450",
       "amountUnits":"g",
       "ingredientName":"藕"
     },
     {
       "amount":"0",
       "amountUnits":"0",
       "ingredientName":"香油"
     },
     {
       "amount":"3",
       "amountUnits":"g",
       "ingredientName":"食盐"
     },
     {
       "amount":"50",
       "amountUnits":"mml",
       "ingredientName":"白醋"
     }
   ],
   "instructions":"1、准备食材 \n 2、姜用工具磨成姜蓉 \n 3、姜用工具磨成姜蓉 \n 4、藕片入开水汆一下，大概3分钟断生，捞出 \n 5、锅里倒入白醋 \n 6、烧至沸腾后加入姜蓉 \n 7、30秒后加入香油和盐，将热姜汁淋入藕片上，腌制20分钟左右即可食用"

 }

我们继续来看，围绕这个简单的模型如何构建更加复杂的UI功能。

控制器、指令及服务器

我们要完成这个应用需要几个指令和控制器代码，然后再来看所需要的控制器。

服务

文件位置menuSolution\app\services\services.js

 var services=angular.module('guthub.services',['ngResource']);
 services.factory('Recipe',['$resource', function ($resource) {
     return $resource('/recipes/:id',{id:'@id'});
 }]);

 services.factory('MultiRecipeLoader',['Recipe','$q', function (Recipe, $q) {
     return function () {
         var delay=$q.defer();
         Recipe.query(function (recipes) {
             delay.resolve(recipes);
         }, function () {
             delay.reject('无法取出食谱');
         });
         return delay.promise;
     };
 }]);

 services.factory('RecipeLoader',['Recipe','$route','$q', function (Recipe,$route,$q) {
     return function () {
         var delay=$q.defer();
         Recipe.get(
             {id:$route.current.params.recipeId},
             function (recipe) {
                 delay.resolve();
             },
             function () {
                 delay.reject('无法取出食谱'+ $route.current.params.recipeId);
             }
         );

         return delay.promise;
     };
 }]);

在以往的章节中已经接触过了服务，这里我们再来深入理解下。在上面的代码中我们实现了三个服务。其中有一个菜谱服务，它返回的东西叫做Angular Resource。Resource将会封装底层的$http服务，所以你的代码只要负责处理对象就可以了。只要一行代码——return $resource(当然需要依赖services.guthub模块)，我们就可以把菜谱作为参数传给任何控制器了，然后菜谱对象就会被注入到控制器中。这样依赖，每个菜谱都具备了下面这些内置的方法：

Recipe.get();
Recipe.save();
Recipe.delete();
Recipe.query();
Recipe.remove();

注：如果你打算使用Recipe.delete();，并且希望在ie中使用它，你必须这样调用它Recipe[delete](),这是因为在IE中delete是一个关键字。

假设我们现在有一个菜谱对象，必要的信息都已经放在就这个对象里面了，包括Id。然后通过下面这些代码我们就可以把它保存起来：

var recipe=new
Recipe(obj);//假设id=13

recipe.$save();

以上代码会向/recipe/13路径发起一次POST请求。

其次，还有两个服务，正两个服务都是加载器：一个是单个菜单加载器，另个一是所有菜单加载器。当我们连接到路由上去，就会用到这两个加载器。它们的核心工作原理非常相似。这两个服务的工作流程如下：

1. 创建一个延迟对象（这些都是angularjs中的promise，用来对异步函数的链式调用）
2. 向服务端发起一次调用
3. 在服务端返回数据之后解析延迟对象
4. 返回promise，angularjs中的路由将会机制将会使用这个对象

Promise是一个接口，他用来处理的对象具有这样的特点：在未来的某一时刻（主要是异步调用）会从服务端返回或者被填充属性。其核心是，promise是一个带有then函数的对象.

使用promise机制的优点如下：

1. 可以对函数链式调用，所以你不会陷入代码缩进噩梦中。
2. 在调用链的过程中，可以保证上一个函数调用完之后才会调用下一个函数。
3. 每一个then()都带有两个参数（两个都是函数），一个是成功之后的回调，一个是出错之后的处理器。
4. 如果调用链中出现了错误，错误将会冒泡传递到其余错误处理函数中。所以，最终来说，所有的错误都可以在任意一个回调函数中处理。

你可能会问，resolve(解决)方法和reject(拒绝)方法又是什么呢?在angular中延迟调用是实现promise的一种方式。调用resolve方法会填充promise（也就是调用success函数），而reject方法将会调用promise的错误处理函数。

指令

现在我们来看看应用中的指令。在目前这款应用中我们会用到如下两条指令。

Butterbar

当路由发生变化同时页面还在加载时，这一指令将会显示和隐藏信息的操作。指令将会被嵌入到路由的变化机制中，然后根据页面的状态自动隐藏或显示其标签中的内容。

Focus

Focus指令要你过来确保特定的输入项（或元素）能否获得焦点。

文件位置
menuSolution\app\directives\directives.js

 var directives=angular.module('guthub.directives',[]);
 directives.directive('butterbar',['$rootScope', function ($rootScope) {
     return {
         link: function (scope,element,attrs) {
             element.addClass('hide');
             $rootScope.$on('$routeChangeStart', function () {
                 element.removeClass('hide');
             });
             $rootScope.$on('$routeChangeSuccess', function () {
                 element.addClass('hide');
             });
         }
     }
 }]);

 directives.directive('focus', function () {
     return {
         link: function (scope, element, sttrs) {
             element[0].focus();
         }
     };
 });

以上指令将会返回一个对象，这个对象只有一个link属性。

1、  指令的处理过程分为两个步骤。在编译过程中，找到绑定在DOM元素上的指令，然后进行处理。所有的DOM操作都发生在编译阶段，在这一阶段结束之后，会产生一个内联函数。

2、  链接阶段中，第一步所产生的DOM模版会变链接到作用域上，会根据需要添加的监控器或者监听器，从而在作用域和元素之间进行动态绑定。这样一来，与作用域相关的所有内容都是在链接阶段进行的。

可以像下面这样使用butterbar指令：

<div butterbar> my loading text……</div>

在一开始的时候只是简单把它隐藏起来，然后在作用域上添加两个监听器。每当路由器发生变化时，它就会显示内部元素。每当路由成功完成变化之后，它又会把butterbar隐藏起来。

另外还有一个有趣的东西是，那就是如何把$tootScope注入到指令中。所有指令都会被直接连接到angularjs的依赖注入系统中。

第二个focus指令更加简单。它实在调用当前元素上的focus()方法而已。你可以在任何元素上添加focus属性来调用它。

<input type=”text” focus/>

当页面加载完成之后，文本框会自动获取焦点。

控制器

文件位置 menuSolution\app\controller\controller.js

写完指令和服务之后，终于改写控制器了，这里我们需要5个控制器。所有这些控制器都位于同一个文件夹中

 var app=angular.module('guthub',['guthub.services','guthub.directives']);
 //第一个控制器:List控制器，他的任务是显示系统中所有菜谱
 //请关注List控制器重要的一件事：在构造器中它不会到i服务器中获取菜谱。相反它会处理一个已经获取到的菜谱列表
 app.controller('ListController',['$scope','recipes', function ($scope, recipes) {
     $scope.recipes=recipes;
 }]);

 //其他控制器与List控制器非常相似
 //edit函数只是把URL地址改成编辑的地址，然后angular就会去做剩余的工作
 app.controller('ViewController',['$scope','$location','recipe', function ($scope,$location,recipe) {
     $scope.recipe=recipe;
     $scope.edit= function () {
       $location.path('/edit/'+recipe.id);
     }
 }]);

 app.controller('EditController',['$scope','$location','recipe', function ($scope,$location,recipe) {
     $scope.recipe=recipe;
     $scope.save= function (recipe) {
         $scope.recipe.save(function () {
             $location.path('/view/'+recipe.id);
         });
     };
     $scope.remove= function () {
         delete $scope.recipe;
         $location.path('/');
     };
 }]);

 app.controller('NewController',['$scope','$location','Recipe', function ($scope,$location,Recipe) {
     $scope.recipe=new Recipe(
         {
             ingredients:[{}]
         }
     );

     $scope.save= function () {
         $scope.recipe.$save(function (recipe) {
             $locale.path('/view/'+recipe.id);
         })
     }
 }]);

 app.controller('IngredientsController',['$scope', function ($scope) {
     $scope.AddIngredient= function () {
         var ingredients=$scope.recipe.ingredients;
         ingredients[ingredients.length]={};
     };
     $scope.removeIngredient= function (index) {
         $scope.recipe.ingredients.splice(index,1);
     }
 }]);

 //创建路由
 app.config([
     '$routeProvider',
     function ($routeProvider) {
         $routeProvider.when('/', {
             controller: 'ListController',
             resolve: {
                 recipes: function (MultiRecipeLoader) {
                     return MultiRecipeLoader();
                 }
             },
             templateUrl: '/views/list.html'
         }).when('/edit/:recipeId', {
             controller: 'EditController',
             resolve: {
                 recipe: function (RecipeLoader) {
                     return RecipeLoader();
                 }
             },
             templateUrl: '/views/recipeForm.html'
         }).when('/view/:recipeId', {
             controller: 'ViewController',
             resolve: {
                 recipe: function (RecipeLoader) {
                     return RecipeLoader();
                 }
             },
             templateUrl: '/views/viewRecipe.html'
         }).when('/new', {
             controller: 'NewController',
             templateUrl: '/views/recipeForm.html'
         }).otherwise({redirectTo: '/'});
     }
 ]);

你可能注意到了，edit和New这两个控制器的路由都指向了相同的模版URL——-/views/recipeForm.html，是怎么回事呢？因为我们会根据关联控制器的不同，在菜谱模版中显示不同的元素。

做完这些之后，我们来看看模版。看看这些控制器是如何把它们关联起来的，以及如何管理显示给最终用户的内容。

模版

我们会从最外层的主模版入手,也是就index.html。他就是我们单页应用的根。其他模版都会加载到这个模版的内部。

模版位置menuSolution\app\views\

主要的模版：

 <!DOCTYPE html>
 <html ng-app="guthub">
 <head>
     <meta charset="UTF-8">
     <title>GutHub</title>
     <script src="static/js/angular.js" type="text/javascript"></script>
     <script src="static/js/angular-resource.js" type="text/javascript"></script>
     <script src="static/js/angular-route.min.js" type="text/javascript"></script>
     <script src="app/directives/directives.js" type="text/javascript"></script>
     <script src="app/services/services.js" type="text/javascript"></script>
     <script src="app/controller/controller.js" type="text/javascript"></script>
     <link rel="stylesheet" href="static/css/bootstrap.css"/>
     <link rel="stylesheet" href="static/css/guthub.css"/>
 </head>
 <body>
 <div butterbar>Loading......</div>
 <div class="container">
     <div class="row">
         <header>
             <h1>GutHub</h1>
         </header>
         <div class="span2">
             <div id="focus"><a href="/#/new">New Recipe</a><br/></div>
             <div><a href="/#/">Recipe List</a></div>
         </div>
         <div class="span2">
             <div ng-view></div>
         </div>
     </div>

 </div>
 </body>
 </html>

在这个模版中有几个比较有趣的元素需要注意，其中大部分已经聊过。其中包括ng-app、ng-view、butterbar 明显还缺少ng-controller。

现在我们来看每个控制器上的模版：

菜谱列表模版：

 <h3>Recipe List</h3>
 <ul class="recips">
     <li ng-repeat="recipe in recipes">
         <div>
             <a ng-href="/#/view/{{recipe.id}}">{{recipe.title}}</a>
         </div>
     </li>
 </ul>

这是一个平淡无奇模版，只有两个地方非常的有趣，一个是ng-repeat标签使用的非常标准。它会从作用域中获取菜单列表，然后遍历它们；另一个是使用ng-href代替了href，这纯粹是为了在angular加载过程中产生错误链接，ng-href无论在何时可以保证都不会把存在缺陷的连接展示给用户。这个模版完了，你可能会问，我怎么没看到控制器呢？而且我们也没有定义主控制器（Main controller）。这正式路由映射派上用场的地方。我们之前说的路由会跳转到列表模版，它上面绑定了List Controller，如过引用了变量之类的东西那么变量就位于List Controller 作用于内。

第二个模版：

 <h2>{{recipe.title}}</h2>
 <div>{{recipe.description}}</div>
 <ul class="list-unstyled">
     <li ng-repeat="ingredient in recipe.ingredients">
         <span>{{ingredient.amount}}</span>
         <span>{{ingredient.amountUnits}}</span>
         <span>{{ingredient.ingredientName}}</span>
     </li>
 </ul>

 <h3>Intructions</h3>
 <div>{{recipe.instructions}}</div>
 <form ng-submit="edit()" class="form-horizontal">
     <div class="form-actions">
         <button class="btn btn-primary">修改</button>
     </div>
 </form>

菜谱表单模版：

 <h2>Edit Recipe</h2>
 <form name="recipeForm" ng-submit="save()" class="form-horizontal">
     <div class="control-group">
         <label class="control-label" for="title">标题:</label>

         <div class="controls">
             <input type="text" ng-model="recipe.title" id="title" class="input-xlarge" focus/>
         </div>
     </div>

     <div class="control-group">
         <label class="control-label" for="description">描述:</label>

         <div class="controls">
             <input type="text" ng-model="recipe.description" id="description" class="input-xlarge" focus/>
         </div>
     </div>

     <div class="control-group">
         <label class="control-label" for="ingredients">原材料:</label>
         <ul class="controls" ng-controller="IngredientsController">
             <li ng-repeat="i in recipe.ingredients">
                 <input type="text" ng-model="i.amount" class=""/>
                 <input type="text" ng-model="i.amountUnits" class=""/>
                 <input type="text" ng-model="i.ingredientName" class=""/>
                 <button class="btn btn-primary" ng-click="removeIngredient($index)">
                     <i class="glyphicon-minus-sign"></i>
                     删除
                 </button>
             </li>
             <button type="button" class="btn btn-primary" ng-click="AddIngredient()">
                 <i class="glyphicon-plus-sign"></i> 添加
             </button>
         </ul>
         <input type="text" ng-model="recipe.ingredients" id="ingredients" class="input-xlarge" focus/>

     </div>

     <div class="control-group">
         <label class="control-label" for="instructions">做法:</label>

         <div class="controls">
             <input type="text" ng-model="recipe.instructions" id="instructions" class="input-xxlarge" focus/>
         </div>
     </div>

     <div class="form-actions">
         <button class="btn btn-primary" ng-click="save()">保存</button>
         <button class="btn btn-primary" ng-show="!recipe.id" ng-click="remove()">删除</button>
     </div>
 </form>

项目架构图：

这个项目比较简单、就不上效果图了。大家可以写一个自己的demo来熟悉angular的各个模块。