AngularJS入门之Services

关于AngularJS中的DI

在开始说AngularJS的Service之前,我们先来简单讲讲DI(Dependency Injection,通常中文称之为“依赖注入”)。

DI是一种软件设计模式,主要为了解决组件获取它的依赖组件的问题。DI的概念渗透在AngularJS的各个地方,AngularJS使用一个专门的子系统($injector)进行DI管理,这个过程包括了创建组件、解析、获取它的依赖组件,并将这些依赖组件回传给请求组件。

我们其实已经在不知不觉中使用DI了(比如在AngularJS自定义Directive中的出现过):

app.directive(‘myCurrentTime‘, [‘$interval‘, ‘dateFilter‘, function ($interval, dateFilter) {
}

上述代码片段在添加Controller时,其中$interval就是Controller中依赖注入Service的推荐方法。由于$injector的存在,对于我们只需将所需服务的名称传入我们的模块即可,底层的工作都将由$injector包办。

$injector的原理如下图:

AngularJS中使用DI添加Service的三种方法:

方式1(内联注解,推荐使用):

app.controller(‘myController‘, [‘$scope‘, ‘dateFilter‘, function ($scope, dateFilter) { }]);

方式2($inject注解):

1 var MyController = function($scope, dateFilter) {
2   // ...
3 }
4 MyController.$inject = [‘$scope‘, ‘dateFilter‘];
5 someModule.controller(‘MyController‘, MyController);

方式3(隐式注解,不推荐使用):

app.controller(‘myController‘, function ($scope, dateFilter) { });

推荐使用方式1的理由是:

  • 写法上比方法2更简单明了
  • 比方法3更可靠(由于Javascript可以被压缩,AngularJS又是通过解析服务名称找到对应Service的,因此Javascript压缩之后AngularJS将无法找到指定的Service,但字符串不会被压缩,因此单独以字符串指定Service的名称可以避免这个问题)

使用方式1或方式2的注意点:

由于上述第二点原因,AngularJS在编译Html时,由$injector将数组中Service的名称与方法体中的Service进行一一映射。这种映射关系必须遵守由AngularJS的约定:

  • 数组中Service名称的个数必须与方法体中Service名称的个数一致
  • 数组中Service的顺序必须与方法体中Serivce的顺序一致

如果为了编码规范需要强制使用显式DI(也就是方式1或者方式2),可使用ng-strict-di属性,这样AngularJS在遇到隐式DI(也就是方式3)时将会报错。

示例1:

 1 <!DOCTYPE >
 2 <html>
 3 <head>
 4     <script src="/Scripts/angular.js"></script>
 5     <script type="text/javascript">
 6         (function () {
 7             var app = angular.module(‘diTest‘, []);
 8
 9             app.controller(‘myController1‘, [‘$scope‘, function ($scope) {
10             }]);
11
12             // 方式1 隐式DI,在指定了ng-strict-di后,将会报错
13             //app.controller(‘myController1‘, function ($scope) {
14             //});
15
16
17
18             var myController2 = function ($scope) {
19             };
20             myController2.$inject = [‘$scope‘];
21             app.controller(‘myController2‘, myController2);
22
23             // 方式2 隐式DI,在指定了ng-strict-di后,将会报错
24             //var myController2 = function ($scope) {
25             //};
26             //app.controller(‘myController2‘, myController2);
27         })();
28     </script>
29 </head>
30 <body ng-app="diTest" ng-strict-di>
31     <div ng-controller="myController1 as myCtrl1">
32     </div>
33
34     <div ng-controller="myController2 as myCtrl2">
35     </div>
36 </body>
37 </html>

示例1中,因为body使用了ng-strict-di属性,因此当使用方式1或者方式2的隐式DI时,AngularJS将会抛出如下错误:

AngularJS中的Services:

AngularJS提供了很多Services,常用的如$http,是集成在AngularJS和核心库中的,另外有一部分如$animate是独立的模块。由于篇幅问题,我们先以$http为例了解一下AngularJS的Service。

迄今为止我所有的AngularJS系列的文章中,所有的数据均是通过ng-init或者在$scope中初始化数组来完成的。但实际项目中,我们的数据都会从服务器获取。写个例子来演示一下这个过程。

Step 1,创建一个名为data.txt的文件,里面包含一个Json对象:

{
    "students": [
        {
            "Name": "Jack",
            "Age": 21
        },
        {
            "Name": "Alice",
            "Age": 20
        },
        {
            "Name": "Tom",
            "Age": 21
        },
        {
            "Name": "Sophie",
            "Age": 19
        }
    ]
}

Step 2,使用$http的get方法获取data.txt的数据,并将数据赋值给$scope.students:

app.controller(‘myController‘, [‘$scope‘, ‘$http‘, function ($scope, $http) {
    $scope.students = [];
    $http.get(‘data.txt‘).
        success(function (data, status, headers, config) {
            $scope.students = data.students;
            console.log(data);
           console.log(data.students);
             console.log($scope.students);
         }).
         error(function (data, status, headers, config) {
         });
 }]);

Step 3,使用ng-repeat显示students的信息:

<div ng-repeat="stu in students">
    <p>Name: {{stu.Name}}</p>
    <p>Age: {{stu.Age}}</p>
    <br />
</div>

完整的Html代码如下:

 1 <!DOCTYPE >
 2 <html>
 3 <head>
 4     <script src="/Scripts/angular.js"></script>
 5     <script type="text/javascript">
 6         (function () {
 7             var app = angular.module(‘httpServiceTest‘, []);
 8
 9             app.controller(‘myController‘, [‘$scope‘, ‘$http‘, function ($scope, $http) {
10                 $scope.students = [];
11                 $http.get(‘data.txt‘).
12                   success(function (data, status, headers, config) {
13                       $scope.students = data.students;
14                       console.log(data);
15                       console.log(data.students);
16                       console.log($scope.students);
17                   }).
18                   error(function (data, status, headers, config) {
19                   });
20             }]);
21         })();
22     </script>
23 </head>
24 <body ng-app="httpServiceTest" ng-controller="myController">
25     <div ng-repeat="stu in students">
26         <p>Name: {{stu.Name}}</p>
27         <p>Age: {{stu.Age}}</p>
28         <br />
29     </div>
30 </body>
31 </html>

关于$http:

$http的基本调用格式:

$http(config).success(function(data,status,headers,config){ }).error(function(data,status,headers,config){ });

config为Json对象,完整参数说明如下:

  • method{string} - HTTP方法,示例值GET、POST等
  • url{string} - 请求资源的绝对或者相对路径,示例值 http://mytest.com/user/example 或 /myservice/user/example
  • params{Object.<string|Object>} - URL的请求参数部分,可以直接是一个完整的字符串也可以是一个对象,对象将被自动JSon序列化(一般给Get使用)
  • data{string|Object} - 请求参数内容(一般给Post使用)
  • headers{Object} - Http请求的Headers
  • xsrfHeaderName{string} - 防XSRF(跨站请求伪造)的Header名称
  • xsrfCookieName{string} - 防XSRF的Cookie名称
  • transformRequest{function(data,headersGetter)|Array.<function(data,headersGetter)>} - 自定义Http请求格式的方法
  • transformResponse{function(data, headersGetter, status)|Array.<function(data, headersGetter, status)>} - 自定义Http响应格式的方法
  • paramSerializer{string|function(Object):string} - 序列化params的方法
  • cache{boolean|Cache} - boolean类型指定是否缓存GET请求,或者指定一个由$cacheFactory创建的缓存实例
  • timeout{number|Promise} - number为请求超时时间(单位为毫秒);或者指定一个可以中断请求的promise
  • withCredentials{boolean} - 是否需要证书,详见:requests with credentials
  • responseType{string} - 返回类型,详见:requestType

注意:由于是入门类文章,本章中对于以上各个参数的用法不深入展开了,这部分内容今后单独开一章来讨论。

$http调用原型中,方法success和error为$http调用返回的promise,promise是由AngularJS的核心服务$q提供的一种处理异步请求的实现方式,关于promise的细节,本篇也不做展开,可参考官方文档:https://docs.angularjs.org/api/ng/service/$q。我们只需知道,由于success和error是$http方法调用返回的promise(承诺),因此在异步完成$http方法的调用完成、失败或超时后,最终必定会调用success或者error方法。

$http的调用原型看起来比较复杂,为了便于使用,AngularJS提供了$http调用的快捷方式(如$http.get, $http.post等),其基本格式如下:

$http.get(‘/someUrl‘).success(successCallback);
$http.post(‘/someUrl‘, data).success(successCallback);

$http所有方法的快捷方式(其中[config]表示config为可选参数):

好了,通过本篇的介绍,我们已经基本了解了DI的概念,以及AngularJS中如何使用DI来完成Service的使用,我们还重点看了一下$http以及它的使用方式,当然,关于更多$http的细节今后会单独开一篇讨论的。

如果你和我一样也是AngularJS的新手,那通过这么多天的学习后,我们已经能使用AngularJS完成一个真正的Web网站的原型的搭建了:AngularJS负责前端,数据由后端服务提供。还犹豫什么呢,赶紧自己试试吧。

参考资料

AngularJS官方文档DI:https://docs.angularjs.org/guide/di

AngularJS官方文档Service:https://docs.angularjs.org/api/ng/service

时间: 2024-11-17 01:44:05

AngularJS入门之Services的相关文章

angularjs入门学习【指令篇】

一.首先我们来了解下指令API 属性 含义 restrict 申明标识符在模版中作为元素,属性,类,注释或组合,如何使用 priority 设置模版中相对于其他标识符的执行顺序 Template 指定一个字符串式的内嵌模版,如果你指定了模版是一个URL,那么是不会使用的 tempateUrl 指定URL加载的模版,如果你已经指定了内嵌的模版字符串,那么它不会使用的 Replace 如果为真,替换当前元素,如果是假或未指定,拼接到当前元素 Transclude 移动一个标识符的原始字节带你到一个新

AngularJS入门心得2——何为双向数据绑定

前言:谁说Test工作比较轻松,最近在熟悉几个case,差点没疯.最近又是断断续续的看我的AngularJS,总觉得自己还是没有入门,可能是自己欠前端的东西太多了,看不了几行代码就有几个常用函数不熟悉的.看过了大漠的视频,算是了解了AngularJS的一些优良特性.后来准备投身<AngularJS权威教程>,跟着它走,可是一来可能自己道行不够,二来,个人觉得这本书翻译的有些生硬以及一些瑕疵,比如: (1)9.2节:在指令中适用自作用域 (2)9.2节:在指令中适用自作用域 当然,以上都是一些瑕

angularjs入门案例 新玩具-中午吃神马

angularjs 是一个用来开发单页webAPP的mvv框架,由Google 开发,如果不知道angularjs 的可以先google 下 按照angularjs 的开发一般顺序先搭建好需要做的视图,然后准备数据,最后绑定事件处理业务逻辑,操作DOM事件用户和程序的交互. 1.开始搭建界面,使用bootstrap作为UI框架,可以快速搭建清爽的界面效果,顺便引入 angular.js jquery.js 和我们需要写的app.js 作为业务逻辑 1 <!doctype html> 2 <

Angular系列----AngularJS入门教程04:迭代器过滤(转载)

我们在上一步做了很多基础性的训练,所以现在我们可以来做一些简单的事情喽.我们要加入全文检索功能(没错,这个真的非常简单!).同时,我们也会写一个端到端测试,因为一个好的端到端测试可以帮上很大忙.它监视着你的应用,并且在发生回归的时候迅速报告. 请重置工作目录: git checkout -f step-3 我们的应用现在有了一个搜索框.注意到页面上的手机列表随着用户在搜索框中的输入而变化. 步骤2和步骤3之间最重要的不同在下面列出.你可以在GitHub里看到完整的差别. 控制器 我们对控制器不做

Angular系列---- AngularJS入门教程03:AngularJS 模板(转载)

是时候给这些网页来点动态特性了——用AngularJS!我们这里为后面要加入的控制器添加了一个测试. 一个应用的代码架构有很多种.对于AngularJS应用,我们鼓励使用模型-视图-控制器(MVC)模式解耦代码和分离关注点.考虑到这一点,我们用AngularJS来为我们的应用添加一些模型.视图和控制器. 请重置工作目录: git checkout -f step-2 我们的应用现在有了一个包含三部手机的列表. 步骤1和步骤2之间最重要的不同在下面列出.,你可以到GitHub去看完整的差别. 视图

Angular系列----AngularJS入门教程01:AngularJS模板 (转载)

是时候给这些网页来点动态特性了——用AngularJS!我们这里为后面要加入的控制器添加了一个测试. 一个应用的代码架构有很多种.对于AngularJS应用,我们鼓励使用模型-视图-控制器(MVC)模式解耦代码和分离关注点.考虑到这一点,我们用AngularJS来为我们的应用添加一些模型.视图和控制器. 请重置工作目录: git checkout -f step-2 我们的应用现在有了一个包含三部手机的列表. 步骤1和步骤2之间最重要的不同在下面列出.,你可以到GitHub去看完整的差别. 视图

Angular系列----AngularJS入门教程00:引导程序(转载)

我们现在开始准备编写AngularJS应用——phonecat.这一步骤(步骤0),您将会熟悉重要的源代码文件,学习启动包含AngularJS种子项目的开发环境,并在浏览器端运行应用. 进入angular-phonecat目录,运行如下命令: git checkout -f step-0 该命令将重置phonecat项目的工作目录,建议您在每一学习步骤运行此命令,将命令中的数字改成您学习步骤对应的数字,该命令将清除您在工作目录内做的任何更改. 运行以下命令: node scripts/web-s

[转载]AngularJS入门教程02:AngularJS模板

是时候给这些网页来点动态特性了——用AngularJS!我们这里为后面要加入的控制器添加了一个测试. 一个应用的代码架构有很多种.对于AngularJS应用,我们鼓励使用模型-视图-控制器(MVC)模式解耦代码和分离关注点.考虑到这一点,我们用AngularJS来为我们的应用添加一些模型.视图和控制器. 请重置工作目录: git checkout -f step-2 我们的应用现在有了一个包含三部手机的列表. 步骤1和步骤2之间最重要的不同在下面列出.,你可以到GitHub去看完整的差别. 视图

Angular系列----AngularJS入门教程02:静态模板(转载)

为了说明angularJS如何增强了标准HTML,我们先将创建一个静态HTML页面模板,然后把这个静态HTML页面模板转换成能动态显示的AngularJS模板. 在本步骤中,我们往HTML页面中添加两个手机的基本信息,用以下命令将工作目录重置到步骤1. git checkout -f step-1 请编辑app/index.html文件,将下面的代码添加到index.html文件中,然后运行该应用查看效果. app/index.html <ul> <li> <span>