Angular简单应用剖析

时间:2022-03-02 20:35:53

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

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

这款应用的特性如下:

a)         两列布局

b)         在左侧有一个导航栏

c)         允许你创建新菜谱

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

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

 

 

模型、控制器和模版(视图)之间的关系

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

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

 

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

   

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

n  展示模型

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

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

n  过滤并格式化数据

 

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

   

      模型

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

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

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

 

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

Angular简单应用剖析Angular简单应用剖析
 1 {
 2   "id":"1",
 3   "title":"热姜汁藕片",
 4   "description":"藕片切得越薄越容易入味。",
 5   "ingredients":[
 6     {
 7       "amount":"450",
 8       "amountUnits":"g",
 9       "ingredientName":"姜"
10     },
11     {
12       "amount":"450",
13       "amountUnits":"g",
14       "ingredientName":"藕"
15     },
16     {
17       "amount":"0",
18       "amountUnits":"0",
19       "ingredientName":"香油"
20     },
21     {
22       "amount":"3",
23       "amountUnits":"g",
24       "ingredientName":"食盐"
25     },
26     {
27       "amount":"50",
28       "amountUnits":"mml",
29       "ingredientName":"白醋"
30     }
31   ],
32   "instructions":"1、准备食材 \n 2、姜用工具磨成姜蓉 \n 3、姜用工具磨成姜蓉 \n 4、藕片入开水汆一下,大概3分钟断生,捞出 \n 5、锅里倒入白醋 \n 6、烧至沸腾后加入姜蓉 \n 7、30秒后加入香油和盐,将热姜汁淋入藕片上,腌制20分钟左右即可食用"
33 
34 }
View Code

 

 

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

控制器、指令及服务器

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

 

服务

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

Angular简单应用剖析Angular简单应用剖析
 1 var services=angular.module('guthub.services',['ngResource']);
 2 services.factory('Recipe',['$resource', function ($resource) {
 3     return $resource('/recipes/:id',{id:'@id'});
 4 }]);
 5 
 6 services.factory('MultiRecipeLoader',['Recipe','$q', function (Recipe, $q) {
 7     return function () {
 8         var delay=$q.defer();
 9         Recipe.query(function (recipes) {
10             delay.resolve(recipes);
11         }, function () {
12             delay.reject('无法取出食谱');
13         });
14         return delay.promise;
15     };
16 }]);
17 
18 services.factory('RecipeLoader',['Recipe','$route','$q', function (Recipe,$route,$q) {
19     return function () {
20         var delay=$q.defer();
21         Recipe.get(
22             {id:$route.current.params.recipeId},
23             function (recipe) {
24                 delay.resolve();
25             },
26             function () {
27                 delay.reject('无法取出食谱'+ $route.current.params.recipeId);
28             }
29         );
30 
31         return delay.promise;
32     };
33 }]);
View Code

 

 

 

在以往的章节中已经接触过了服务,这里我们再来深入理解下。在上面的代码中我们实现了三个服务。其中有一个菜谱服务,它返回的东西叫做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

Angular简单应用剖析Angular简单应用剖析
 1 var directives=angular.module('guthub.directives',[]);
 2 directives.directive('butterbar',['$rootScope', function ($rootScope) {
 3     return {
 4         link: function (scope,element,attrs) {
 5             element.addClass('hide');
 6             $rootScope.$on('$routeChangeStart', function () {
 7                 element.removeClass('hide');
 8             });
 9             $rootScope.$on('$routeChangeSuccess', function () {
10                 element.addClass('hide');
11             });
12         }
13     }
14 }]);
15 
16 directives.directive('focus', function () {
17     return {
18         link: function (scope, element, sttrs) {
19             element[0].focus();
20         }
21     };
22 });
View Code

 

 

 

以上指令将会返回一个对象,这个对象只有一个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个控制器。所有这些控制器都位于同一个文件夹中

Angular简单应用剖析Angular简单应用剖析
 1 var app=angular.module('guthub',['guthub.services','guthub.directives']);
 2 //第一个控制器:List控制器,他的任务是显示系统中所有菜谱
 3 //请关注List控制器重要的一件事:在构造器中它不会到i服务器中获取菜谱。相反它会处理一个已经获取到的菜谱列表
 4 app.controller('ListController',['$scope','recipes', function ($scope, recipes) {
 5     $scope.recipes=recipes;
 6 }]);
 7 
 8 //其他控制器与List控制器非常相似
 9 //edit函数只是把URL地址改成编辑的地址,然后angular就会去做剩余的工作
10 app.controller('ViewController',['$scope','$location','recipe', function ($scope,$location,recipe) {
11     $scope.recipe=recipe;
12     $scope.edit= function () {
13       $location.path('/edit/'+recipe.id);
14     }
15 }]);
16 
17 
18 
19 app.controller('EditController',['$scope','$location','recipe', function ($scope,$location,recipe) {
20     $scope.recipe=recipe;
21     $scope.save= function (recipe) {
22         $scope.recipe.save(function () {
23             $location.path('/view/'+recipe.id);
24         });
25     };
26     $scope.remove= function () {
27         delete $scope.recipe;
28         $location.path('/');
29     };
30 }]);
31 
32 app.controller('NewController',['$scope','$location','Recipe', function ($scope,$location,Recipe) {
33     $scope.recipe=new Recipe(
34         {
35             ingredients:[{}]
36         }
37     );
38 
39     $scope.save= function () {
40         $scope.recipe.$save(function (recipe) {
41             $locale.path('/view/'+recipe.id);
42         })
43     }
44 }]);
45 
46 
47 app.controller('IngredientsController',['$scope', function ($scope) {
48     $scope.AddIngredient= function () {
49         var ingredients=$scope.recipe.ingredients;
50         ingredients[ingredients.length]={};
51     };
52     $scope.removeIngredient= function (index) {
53         $scope.recipe.ingredients.splice(index,1);
54     }
55 }]);
56 
57  
58 
59 
60 //创建路由
61 app.config([
62     '$routeProvider',
63     function ($routeProvider) {
64         $routeProvider.when('/', {
65             controller: 'ListController',
66             resolve: {
67                 recipes: function (MultiRecipeLoader) {
68                     return MultiRecipeLoader();
69                 }
70             },
71             templateUrl: '/views/list.html'
72         }).when('/edit/:recipeId', {
73             controller: 'EditController',
74             resolve: {
75                 recipe: function (RecipeLoader) {
76                     return RecipeLoader();
77                 }
78             },
79             templateUrl: '/views/recipeForm.html'
80         }).when('/view/:recipeId', {
81             controller: 'ViewController',
82             resolve: {
83                 recipe: function (RecipeLoader) {
84                     return RecipeLoader();
85                 }
86             },
87             templateUrl: '/views/viewRecipe.html'
88         }).when('/new', {
89             controller: 'NewController',
90             templateUrl: '/views/recipeForm.html'
91         }).otherwise({redirectTo: '/'});
92     }
93 ]);
94 
95  
View Code

 

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

 

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

 

模版

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

模版位置menuSolution\app\views\

主要的模版:

Angular简单应用剖析Angular简单应用剖析
 1 <!DOCTYPE html>
 2 <html ng-app="guthub">
 3 <head>
 4     <meta charset="UTF-8">
 5     <title>GutHub</title>
 6     <script src="static/js/angular.js" type="text/javascript"></script>
 7     <script src="static/js/angular-resource.js" type="text/javascript"></script>
 8     <script src="static/js/angular-route.min.js" type="text/javascript"></script>
 9     <script src="app/directives/directives.js" type="text/javascript"></script>
10     <script src="app/services/services.js" type="text/javascript"></script>
11     <script src="app/controller/controller.js" type="text/javascript"></script>
12     <link rel="stylesheet" href="static/css/bootstrap.css"/>
13     <link rel="stylesheet" href="static/css/guthub.css"/>
14 </head>
15 <body>
16 <div butterbar>Loading......</div>
17 <div class="container">
18     <div class="row">
19         <header>
20             <h1>GutHub</h1>
21         </header>
22         <div class="span2">
23             <div id="focus"><a href="/#/new">New Recipe</a><br/></div>
24             <div><a href="/#/">Recipe List</a></div>
25         </div>
26         <div class="span2">
27             <div ng-view></div>
28         </div>
29     </div>
30 
31 </div>
32 </body>
33 </html>
View Code

 

 

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

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

菜谱列表模版:

Angular简单应用剖析Angular简单应用剖析
1 <h3>Recipe List</h3>
2 <ul class="recips">
3     <li ng-repeat="recipe in recipes">
4         <div>
5             <a ng-href="/#/view/{{recipe.id}}">{{recipe.title}}</a>
6         </div>
7     </li>
8 </ul>
View Code  

 

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

 

第二个模版:

Angular简单应用剖析Angular简单应用剖析
 1 <h2>{{recipe.title}}</h2>
 2 <div>{{recipe.description}}</div>
 3 <ul class="list-unstyled">
 4     <li ng-repeat="ingredient in recipe.ingredients">
 5         <span>{{ingredient.amount}}</span>
 6         <span>{{ingredient.amountUnits}}</span>
 7         <span>{{ingredient.ingredientName}}</span>
 8     </li>
 9 </ul>
10 
11 <h3>Intructions</h3>
12 <div>{{recipe.instructions}}</div>
13 <form ng-submit="edit()" class="form-horizontal">
14     <div class="form-actions">
15         <button class="btn btn-primary">修改</button>
16     </div>
17 </form>
18 
19  
View Code  

 

菜谱表单模版: 

 

Angular简单应用剖析Angular简单应用剖析
 1 <h2>Edit Recipe</h2>
 2 <form name="recipeForm" ng-submit="save()" class="form-horizontal">
 3     <div class="control-group">
 4         <label class="control-label" for="title">标题:</label>
 5 
 6         <div class="controls">
 7             <input type="text" ng-model="recipe.title" id="title" class="input-xlarge" focus/>
 8         </div>
 9     </div>
10 
11     <div class="control-group">
12         <label class="control-label" for="description">描述:</label>
13 
14         <div class="controls">
15             <input type="text" ng-model="recipe.description" id="description" class="input-xlarge" focus/>
16         </div>
17     </div>
18 
19 
20     <div class="control-group">
21         <label class="control-label" for="ingredients">原材料:</label>
22         <ul class="controls" ng-controller="IngredientsController">
23             <li ng-repeat="i in recipe.ingredients">
24                 <input type="text" ng-model="i.amount" class=""/>
25                 <input type="text" ng-model="i.amountUnits" class=""/>
26                 <input type="text" ng-model="i.ingredientName" class=""/>
27                 <button class="btn btn-primary" ng-click="removeIngredient($index)">
28                     <i class="glyphicon-minus-sign"></i>
29                     删除
30                 </button>
31             </li>
32             <button type="button" class="btn btn-primary" ng-click="AddIngredient()">
33                 <i class="glyphicon-plus-sign"></i> 添加
34             </button>
35         </ul>
36         <input type="text" ng-model="recipe.ingredients" id="ingredients" class="input-xlarge" focus/>
37 
38     </div>
39 
40 
41     <div class="control-group">
42         <label class="control-label" for="instructions">做法:</label>
43 
44         <div class="controls">
45             <input type="text" ng-model="recipe.instructions" id="instructions" class="input-xxlarge" focus/>
46         </div>
47     </div>
48 
49     <div class="form-actions">
50         <button class="btn btn-primary" ng-click="save()">保存</button>
51         <button class="btn btn-primary" ng-show="!recipe.id" ng-click="remove()">删除</button>
52     </div>
53 </form>
View Code

 

项目架构图:

 

 Angular简单应用剖析

 

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