AngularJS入门教程之REST和定制服务详解
在这一步中,我们会改进我们APP获取数据的方式。
请重置工作目录:
gitcheckout-fstep-11
对我们应用所做的最后一个改进就是定义一个代表RESTful客户端的定制服务。有了这个客户端我们可以用一种更简单的方式来发送XHR请求,而不用去关心更底层的$http服务(API、HTTP方法和URL)。
步骤9和步骤10之间最重要的不同在下面列出。你可以在GitHub里看到完整的差别。
模板
定制的服务被定义在app/js/services,所以我们需要在布局模板中引入这个文件。另外,我们也要加载angularjs-resource.js这个文件,它包含了ngResource模块以及其中的$resource服务,我们一会就会用到它们:
app/index.html
... <scriptsrc="js/services.js"></script> <scriptsrc="lib/angular/angular-resource.js"></script> ...
服务
app/js/services.js
angular.module('phonecatServices',['ngResource']).
factory('Phone',function($resource){
return$resource('phones/:phoneId.json',{},{
query:{method:'GET',params:{phoneId:'phones'},isArray:true}
});
});
我们使用模块API通过一个工厂方法注册了一个定制服务。我们传入服务的名字Phone和工厂函数。工厂函数和控制器构造函数差不多,它们都通过函数参数声明依赖服务。Phone服务声明了它依赖于$resource服务。
$resource服务使得用短短的几行代码就可以创建一个RESTful客户端。我们的应用使用这个客户端来代替底层的$http服务。
app/js/app.js
...
angular.module('phonecat',['phonecatFilters','phonecatServices']).
...
我们需要把phonecatServices添加到phonecat的依赖数组里。
控制器
通过重构掉底层的$http服务,把它放在一个新的服务Phone中,我们可以大大简化子控制器(PhoneListCtrl和PhoneDetailCtrl)。AngularJS的$resource相比于$http更加适合于与RESTful数据源交互。而且现在我们更容易理解控制器这些代码在干什么了。
app/js/controllers.js
...
functionPhoneListCtrl($scope,Phone){
$scope.phones=Phone.query();
$scope.orderProp='age';
}
//PhoneListCtrl.$inject=['$scope','Phone'];
functionPhoneDetailCtrl($scope,$routeParams,Phone){
$scope.phone=Phone.get({phoneId:$routeParams.phoneId},function(phone){
$scope.mainImageUrl=phone.images[0];
});
$scope.setImage=function(imageUrl){
$scope.mainImageUrl=imageUrl;
}
}
//PhoneDetailCtrl.$inject=['$scope','$routeParams','Phone'];
注意到,在PhoneListCtrl里我们把:
$http.get('phones/phones.json').success(function(data){
$scope.phones=data;
});
换成了:
$scope.phones=Phone.query();
我们通过这条简单的语句来查询所有的手机。
另一个非常需要注意的是,在上面的代码里面,当调用Phone服务的方法是我们并没有传递任何回调函数。尽管这看起来结果是同步返回的,其实根本就不是。被同步返回的是一个“future”——一个对象,当XHR相应返回的时候会填充进数据。鉴于AngularJS的数据绑定,我们可以使用future并且把它绑定到我们的模板上。然后,当数据到达时,我们的视图会自动更新。
有的时候,单单依赖future对象和数据绑定不足以满足我们的需求,所以在这些情况下,我们需要添加一个回调函数来处理服务器的响应。PhoneDetailCtrl控制器通过在一个回调函数中设置mainImageUrl就是一个解释。
测试
修改我们的单元测试来验证我们新的服务会发起HTTP请求并且按照预期地处理它们。测试同时也检查了我们的控制器是否与服务正确协作。
$resource服务通过添加更新和删除资源的方法来增强响应得到的对象。如果我们打算使用toEqual匹配器,我们的测试会失败,因为测试值并不会和响应完全等同。为了解决这个问题,我们需要使用一个最近定义的toEqualDataJasmine匹配器。当toEqualData匹配器比较两个对象的时候,它只考虑对象的属性而忽略掉所有的方法。
test/unit/controllersSpec.js:
describe('PhoneCatcontrollers',function(){
beforeEach(function(){
this.addMatchers({
toEqualData:function(expected){
returnangular.equals(this.actual,expected);
}
});
});
beforeEach(module('phonecatServices'));
describe('PhoneListCtrl',function(){
varscope,ctrl,$httpBackend;
beforeEach(inject(function(_$httpBackend_,$rootScope,$controller){
$httpBackend=_$httpBackend_;
$httpBackend.expectGET('phones/phones.json').
respond([{name:'NexusS'},{name:'MotorolaDROID'}]);
scope=$rootScope.$new();
ctrl=$controller(PhoneListCtrl,{$scope:scope});
}));
it('shouldcreate"phones"modelwith2phonesfetchedfromxhr',function(){
expect(scope.phones).toEqual([]);
$httpBackend.flush();
expect(scope.phones).toEqualData(
[{name:'NexusS'},{name:'MotorolaDROID'}]);
});
it('shouldsetthedefaultvalueoforderPropmodel',function(){
expect(scope.orderProp).toBe('age');
});
});
describe('PhoneDetailCtrl',function(){
varscope,$httpBackend,ctrl,
xyzPhoneData=function(){
return{
name:'phonexyz',
images:['image/url1.png','image/url2.png']
}
};
beforeEach(inject(function(_$httpBackend_,$rootScope,$routeParams,$controller){
$httpBackend=_$httpBackend_;
$httpBackend.expectGET('phones/xyz.json').respond(xyzPhoneData());
$routeParams.phoneId='xyz';
scope=$rootScope.$new();
ctrl=$controller(PhoneDetailCtrl,{$scope:scope});
}));
it('shouldfetchphonedetail',function(){
expect(scope.phone).toEqualData({});
$httpBackend.flush();
expect(scope.phone).toEqualData(xyzPhoneData());
});
});
});
执行./scripts/test.sh运行测试,你应该会看到如下的输出:
Chrome:Runnerreset. .... Total4tests(Passed:4;Fails:0;Errors:0)(3.00ms) Chrome19.0.1084.36MacOS:Run4tests(Passed:4;Fails:0;Errors0)(3.00ms)
总结
完工!你在相当短的时间内已经创建了一个Web应用。在完结篇里面我们会提起接下来应该干什么。
以上就是AngularJSRES和定制服务的资料整理,后续继续补充相关资料,希望能帮助大家学习AngularJS!