$http
我们可以使用内置的$http
服务直接同外部进行通信。$http
服务只是简单的封装了浏览器原生的XMLHttpRequest
对象。
$http
服务是只能接受一个参数的函数,这个参数是一个对象,包含了用来生成HTTP请求的配置内容。这个函数返回一个promise
对象,具有success
和error
两个方法。
$http({
method: 'GET',
url: '/api/users.json'
}).success(function(data,status,headers,config) {
// 当响应准备就绪时调用
}).error(function(data,status,headers,config) {
// 当响应以错误状态返回时调用
});
当$http
返回promise
对象时,我们可以将$http
的运行结果当作变量一并返回,并将其他promise
同它串联在一起,进行链式的调用。在创建服务时会频繁使用链式调用技术,因此服务可以返回一个promise
对象,而不需要回调函数。
var promise = $http({
method: 'GET',
url: '/api/users.json'
});
由于$http
方法返回一个promise
对象,我们可以在响应返回时用then
方法来处理回调。如果使用then
方法,会得到一个特殊的参数,它代表了相应对象的成功或失败信息,还可以接受两个可选的函数作为参数。或者可以使用success
和error
回调代替。
promise.then(function(resp){
// resp是一个响应对象
}, function(resp) {
// 带有错误信息的resp
});
// 或者使用success/error方法
promise.success(function(data, status, headers, config){
// 处理成功的响应
});
// 错误处理
promise.error(function(data, status, headers, config){
// 处理非成功的响应
});
如果响应状态码在200和299之间,会认为响应是成功的,success
回调会被调用,否则error
回调会被调用。如果响应结果是重定向,XMLHttpRequest
会跟进这个重定向,error
回调并不会被调用。
我们可以调用Http promise
对象上的then()
、success()
和error()
方法。then()
方法与其他两种方法的主要区别是,它会接收到完整的响应对象,而success()
和error()
则会对响应对象进行析构。
调用http
方法后,在下一个$digest
循环运行之前它并不会被真正执行。尽管大部分情况下我们都是在$apply
代码块内部使用$http
,但也可以在AngularJS的$digest
循环以外执行这个方法。
如果要在AngularJS的$digest
循环以外执行$http
函数,需要将其封装在一个$apply
代码块中。这样会强制digest
循环执行,我们的promise
可以按预期那样被resolve
。
$scope.$apply(function(){
$http({
method: 'GET',
url: '/api/users.json'
});
});
快捷方法
1.get()
发送GET请求的快捷方式。get()
函数可以接受两个参数。
- url(字符串):一个绝对或相对路径的URL,代表请求的目的地。
- config(可选,对象):
get()
方法返回Http promise
对象。
2.delete()
用来发送DELETE请求的快捷方式。delete()
函数可以接受两个参数。
- url(字符串):一个绝对或相对路径的URL,代表请求的目的地。
- config(可选,对象):
delete()
方法返回Http promise
对象。
3.head()
发送HEAD请求的快捷方式。head()
函数可以接受两个参数。
- url(字符串):一个绝对或相对路径的URL,代表请求的目的地。
- config(可选,对象):
head()
方法返回Http promise
对象。
4.jsonp()
发送JSONP请求的快捷方式。jsonp()
函数可以接受两个参数。
- url(字符串):一个绝对或相对路径的URL,代表请求的目的地。为了发送JSONP请求,其中必须包含
JSON_CALLBACK
字样。
$http.jsonp("/api/users.json?callback=JSON_CALLBACK");
- config(可选,对象):
jsonp()
方法返回Http promise
对象。
5.post()
发送POST请求的快捷方式。post()
函数可以接受三个参数。
- url(字符串):一个绝对或相对路径的URL,代表请求的目的地。
- data(对象或字符串):这个对象包含请求的数据。
- config(可选,对象):
post()
方法返回Http promise
对象。
6.put()
发送PUT请求的快捷方式。put()
函数可以接受三个参数。
- url(字符串):一个绝对或相对路径的URL,代表请求的目的地。
- data(对象或字符串):这个对象包含请求的数据。
- config(可选,对象):
put()
方法返回Http promise
对象。
设置对象
当我们将$http
当作函数来调用时,需要传入一个设置对象,用来说明如何构造XHR
对象。
$http({
method: 'GET',
url: '/api/users.json',
params: {
'username': 'auser'
}
});
设置对象可以包含以下键。
1.method(字符串)
这个键是我们希望发送的请求的HTTP方法。它的值是下列各项其中之一:GET
、DELETE
、HEAD
、JSONP
、POST
、PUT
。
2.url(字符串)
绝对或相对的URL,是请求的目标。
3.params(字符串map或对象)
这个键的值是一个字符串map
或对象,会被转换成查询字符串追加在URL后面。如果值不是字符串,会被JSON序列化。
// 参数会转化为?name=ari的形式
$http({
params: {'name': 'ari'}
})
4.data(字符串或对象)
这个对象中包含了将会被当作消息体发送给服务器的数据。通常在发送POST请求时使用。它还可以在POST请求里发送二进制数据。要发送一个blob
对象,可以简单地通过使用data
参数来传递它。
var blob = new Blob(['Hello World'], {type: 'text/plain'});
$http({
method: 'POST',
url: '/',
data: blob
});
5.headers(对象)
一个列表,每一个元素都是一个函数,它会返回代表随请求发送的HTTP头。如果函数的返回值是null
,对应的头不会被发送。
6.xsrfHeaderName(字符串)
保存XSFR令牌的HTTP头的名称。
7.xsrfCookieName(字符串)
保存XSFR令牌的cookie
的名称。
8.transformRequest(函数或函数数组)
这是一个函数或函数数组,用来对HTTP请求的请求体和头信息进行转换,并返回转换后的版本。通常用于在请求发送给服务器之前对其进行序列化。
function(data,headers) {}
9.transformResponse(函数或函数数组)
这是一个函数或函数数组,用来对HTTP响应的响应体和头信息进行转换,并返回转换后的版本。通常用来进行反序列化。
function(data,headers) {}
10.cache(布尔型或缓存对象)
如果cache
属性被设置为true
,那么AngularJS会用默认的$http
缓存来对GET请求进行缓存。
如果cache
属性被设置为一个$cacheFactory
对象的实例,那么这个对象会被用来对GET请求进行缓存。
11.timeout(数值型或promise对象)
如果timeout
被设置为一个数值,那么请求将会在推迟timeout
指定的毫秒数后再发送。如果被设置为一个promise
对象,那么当该promise
对象被resolve
时请求会被中止。
12.withCredentials(布尔型)
如果该属性被设置为true
,那么XHR请求对象中会设置withCredentials
标记。
默认情况下,CORS请求不会发送cookie
, 而withCredentials
标记会在请求中加入Access-Control-Allow-Credentials
头,这样请求就会将目标域的cookie
包含在请求中。
13.responseType(字符串)
responseType
选项会在请求中设置XMLHttpRequestResponseType
属性。可以使用以下HTTP请求类型其中之一:
- ""(字符串,默认)
- "arraybuffer"(ArrayBuffer)
- "blob"(blob对象)
- "document"(HTTP文档)
- "json"(从JSON对象解析而来的JSON字符串)
- "text"(字符串)
- "moz-blob"(Firefox的接收进度事件)
- "moz-chunked-text"(文本流)
- "moz-chunked-arraybuffer"(ArrayBuffer流)
响应对象
AngularJS传递给then()
方法的响应对象包含四个属性。
- data(字符串或对象):这个数据代表转换过后的响应体。
- status(数值型):响应的HTTP状态码。
- headers(函数):这个函数是头信息的
getter
函数,可以接受一个参数,用来获取对应名字的值。
$http({
method: 'GET',
url: '/api/users.json'
}).then (resp) {
resp.headers('X-Auth-ID'); // 读取X-Auth-ID
});
- config(对象):这个对象是用来生成原始请求的完整设置对象。
- statusText(字符串):这个字符串是响应的HTTP状态文本。
缓存HTTP请求
默认情况下,$http
服务不会对请求进行本地缓存。在发送单独的请求时,我们可以通过向$http
请求传入一个布尔值或者一个缓存实例来启用缓存。
$http.get('/api/users.json',{cache: true})
.success(function(data) {})
.error(function(data) {});
第一次发送请求时,$http
服务会向/api/users.json
发送一个GET请求。第二次发送同一个GET请求时,$http
服务会从缓存中取回请求的结果,而不会真的发送一个HTTP GET请求。
在这个例子里,由于设置了启用缓存,AngularJS默认会使用$cacheFactory
,这个服务是AngularJS在启动时自动创建的。
如果想要对AngularJS使用的缓存进行更多的自定义控制,可以向请求传入一个自定义的缓存实例代替true
。
例如,如果要使用LRU(Least Recenlty Used,最近最少使用)缓存,可以像下面这样传入缓存实例对象:
var lru = $cacheFactory('lru',{
capacity: 20
});
$http.get('/api/users.json', { cache: lru })
.success(function(data){})
.error(function(data){});
现在,最新的20个请求会被缓存。第21个请求会导致LRU从缓存中将时间比较老的请求移除掉。 每次发送请求时都传入一个自定义缓存是很麻烦的事情。可以通过应用的.config()
函数给所有$http
请求设置一个默认的缓存:
angular.module('myApp', [])
.config(function($httpProvider, $cacheFactory) {
$httpProvider.defaults.cache = $cacheFactory('lru', {
capacity: 20
});
});
现在,所有的请求都会使用我们自定义的LRU缓存了。
拦截器
任何时候如果我们想要为请求添加全局功能,例如身份验证、错误处理等,在请求发送给服 务器之前或者从服务器返回时对其进行拦截,是比较好的实现手段。
例如对于身份验证,如果服务器返回401状态码,我们会希望将用户重定向到登录页面。 AngularJS通过拦截器提供了一个从全局层面对响应进行处理的途径。
拦截器实际上是$http
服务的基础中间件,用来向应用的业务流程中注入新的逻辑。
拦截器的核心是服务工厂,通过向$httpProvider.interceptors
数组中添加服务工厂,在$httpProvider
中进行注册。
一共有四种拦截器,两种成功拦截器,两种失败拦截器。
- request
AngularJS通过$http
设置对象来对请求拦截器进行调用。它可以对设置对象进行修改,或者创建一个新的设置对象,它需要返回一个更新过的设置对象,或者一个可以返回新的设置对象的promise
。 - response
AngularJS通过$http
设置对象来对响应拦截器进行调用。它可以对响应进行修改,或者创建 一个新的响应,它需要返回一个更新过的响应,或者一个可以返回新响应的promise
。 - requestError
AngularJS会在上一个请求拦截器抛出错误,或者promise
被reject
时调用此拦截器。 - responseError
AngularJS会在上一个响应拦截器抛出错误,或者promise
被reject
时调用此拦截器。
调用模块的.factory()
方法来创建拦截器,可以在服务中添加一种或多种拦截器。
angular.module('myApp', []).factory('myInterceptor', function($q) {
var interceptor = {
'request': function(config) {
// 成功的请求方法
return config; // 或者 $q.when(config);
},
'response': function(response) {
// 响应成功
return response; // 或者 $q.when(config);
},
'requestError': function(rejection) {
// 请求发生了错误,如果能从错误中恢复,可以返回一个新的请求或promise
return response; // 或新的promise
// 或者,可以通过返回一个rejection来阻止下一步
// return $q.reject(rejection);
},
'responseError': function(rejection) {
// 请求发生了错误,如果能从错误中恢复,可以返回一个新的响应或promise
return rejection; // 或新的promise
// 或者,可以通过返回一个rejection来阻止下一步
// return $q.reject(rejection);
}
};
return interceptor;
});
我们需要使用$httpProvider
在.config()
函数中注册拦截器:
angular.module('myApp', []) .config(function($httpProvider) {
$httpProvider.interceptors.push('myInterceptor');
});
设置$httpProvider
使用.config()
可以向所有请求中添加特定的HTTP头,这非常有用,尤其是我们希望将身份验证的头同请求一同发送,或设置响应类型的时候。
默认的请求头保存在$httpProvider.defaults.headers.common
对象中。默认的头如下所示:
Accept: application/json, text/plain, */*
通过.config()
函数可以对这些头进行修改或扩充。
angular.module('myApp', []) .config(function($httpProvider) {
$httpProvider.defaults.headers
.common['X-Requested-By'] = 'MyAngularApp';
});
也可以在运行时通过$http
对象的defaults
属性对这些默认值进行修改。例如,通过如下方 法可以动态添加一个头:
$http.defaults
.common['X-Auth'] = 'RandomString';
这个功能可以通过使用请求转换器实现,对于单个请求,也可以通过设置$http
请求的headers
选项实现。
也可以只对POST和PUT类型的请求进行设置。
Content-Type: application/json //POST请求的默认头
可以在.config()
函数中对POST请求的头进行修改或扩充。
angular.module('myApp', [])
.config(function($httpProvider) {
$httpProvider.defaults.headers
.post['X-Posted-By'] = 'MyAngularApp';
});
也可以对所有的PUT请求做同样的设置。
Content-Type: application/json //PUT请求的默认头
可以在.config()
函数中对PUT请求的头进行修改或扩充。
angular.module('myApp',[]).config(function($httpProvider){
$httpProvider.defaults.headers
.put['X-Posted-By'] = 'MyAngularApp';
});
使用$resource
AngularJS还提供另外一个非常有用的可选服务$resource
供我们使用。这个服务可以创建一 个资源对象,我们可以用它非常方便地同支持RESTful
的服务端数据源进行交互,当同支持RESTful
的数据模型一起工作时,它就派上用场了。
$resource
服务可以将$http
请求转换成save
和update
等简单形式。
安装
ngResource
模块是一个可选的AngularJS模块,支持与RESTful
的后端数据源进行交互。由于ngResource
模块没有默认内置在AngularJS中,因此我们需要安装并在应用中引用它。
$ bower install --save angular-resouce
<script src="js/vendor/angular.js"></script>
<script src="js/vendor/angular-resource.js"></script>
angular.module('myApp', ['ngResource']);
现在可以使用$resource
服务了。
应用$resource
$resource
服务本身是一个创建资源对象的工厂。返回的$resource
对象中包含了同后端服务器进行交互的高层API。
var User = $resource('/api/users/:userId.json', {userId:'@id'});
$resource
返回包含了几个默认动作的资源类对象。可以把User
对象理解成同RESTful
的后端服务进行交互的接口。
默认情况下,这个对象包含了五个常用的方法,可以同资源集合进行交互,或者创建资源对象的实例。它会生成两个基于HTTP GET类型的方法,以及三个非GET类型的方法。
基于HTTP GET方法
两个HTTP GET类型的方法可以接受下面三个参数。
- params(对象):随请求一起发送的参数。它们可以是URL中的具名参数,也可以是查询参数。 successFn(函数):当HTTP响应成功时的回调函数。
- errorFn(函数):当HTTP响应非成功时的回调函数。
1.get(params,successFn,errorFn)
get
方法向指定URL发送一个GET请求,并期望一个JSON类型的响应。像上面那样不定义具体的参数,get()
请求通常被用来获取单个资源。
// 发起一个请求:GET /api/users
User.get(function(resp) {
// 处理响应成功
}, function(err) {
// 处理错误
});
如果参数中传入了具名参数,那么get()
方法会向包含id
的URL发送请求:
// 发起一个请求:GET /api/users/123
User.get({
id: '123'
}, function(resp) {
// 处理响应成功
}, function(err) {
// 处理错误
});
2.query(params,successFn,errorFn)
query
向指定URL发送一个GET请求,并期望返回一个JSON格式的资源对象集合。
// 发起一个请求:GET /api/users
User.query(function(users) {
// 读取集合中第一个用户
var user = users[0];
});
query()
和get()
方法之间唯一的区别是AngularJS期望query()
方法返回数组。
基于非HTTP GET类型的方法
三个基于非HTTP GET类型的方法可以接受下面四个参数。
- params(对象)
随请求一起发送的参数。它们可以是URL中的具名参数,也可以是查询参数。 - postData(对象):这个对象是随请求发送的数据体。
- successFn(函数):当HTTP响应成功时的回调函数。
- errorFn(函数):当HTTP响应非成功时的回调函数。
1.save(params,payload,successFn,errorFn)
save
方法向指定URL发送一个POST请求,并用数据体来生成请求体。save()
方法用来在服务器上生成一个新的资源。
// 发起一个请求:POST /api/users
// with the body {name: 'Ari'}
User.save({}, {
name: 'Ari'
}, function(response) {
// 处理响应成功
}, function(response) {
// 处理非成功响应
});
2.delete(params,payload,successFn,errorFn)
delete
方法会向指定URL发送一个DELETE请求,并用数据体来生成请求体。它被用来在服务器上删除一个实例。
// 发起一个请求:DELETE /api/users
User.delete({}, {
id: '123'
}, function(response) {
// 处理成功的删除响应
}, function(response) {
// 处理非成功的删除响应
});
3.remove(params,payload,successFn,errorFn)
remove
方法和delete()
方法的作用是完全相同的,它存在的意义是因为delete
是JS的保留字,在IE浏览器中会导致额外的问题。
// 发起一个请求:DELETE /api/users
User.remove({}, {
id: '123'
}, function(response) {
// 处理成功的删除响应
}, function(response) {
// 处理非成功的删除响应
});
$resource实例
上述方法返回数据时,响应会被一个原型类所包装,并在实例上添加一些有用的方法。实例对象上会被添加三个实例方法:$save()
、$remove()
、$delete()
。
除非在一个单独的资源上而不是一个集合上被调用,否则这三个方法与资源上对应的方法是一样的。这三个方法可以在资源实例上被调用。
// 使用实例方法$save()
User.get({id: '123'}, function(user) {
user.name = 'Ari';
user.$save(); // Save the user
});
// This is equivalent to the collection-level
// resource call
User.save({id: '123'}, {name: 'Ari'});
$resource实例是异步的
需要格外注意,这三个方法在调用时$resource
对象会立即返回一个空的数据引用。由于所有方法都是异步执行的,所以这个数据是一个空的引用,并不是真实的数据。
因此,虽然获取实例的调用看起来是同步的,但实际上不是。事实上,它只是数据的引用,当数据从服务器返回后AngularJS会自动将数据填充进去。
// $scope.user将为空
$scope.user = User.get({id: '123'});
这些方法也提供了回调函数,在数据返回时按预期的方式调用:
User.get({id: '123'}, function(user) {
$scope.user = user;
});
附加属性
$resource
集合和实例有两个特殊的属性用来同底层的数据定义进行交互。
- $promise(promise):
$promise
属性是为$resource
生成的原始promise
对象。这个属性是特别用来同$routeProvider.when()
在resolve
时进行连接的。
如果请求成功了,资源实例或集合对象会随promise
的resolve
一起返回。如果请求失败了,promise
被resolve
时会返回HTTP响应对象,其中没有resource
属性。 - $resolved(布尔型) :
$resolved
属性在服务器首次响应时会被设置为true
(无论请求是否成功)。
自定义$resource方法
尽管$resource
服务提供了五种方法供我们使用,但它本身也具有良好扩展性,我们可以用自定义方法对资源对象进行扩展。
为了在$resource
对象中创建自定义方法,需要向包含修改过的$http
设置对象的资源类传入第三个参数,它被当作自定义方法。
在这个对象中,键是方法的名称,值是$http
设置对象。
var User = $resource('/api/users/:userId.json', {
userId: '@id'
sendEmail: {
method: 'POST'
},
allInboxes: {
method: 'JSONP',
isArray: true
}
});
借助这个User
资源,资源集合(User
资源对象)中的个体实例现在可以使用sendEmail()
和update()
方法了(也就是user.$sendEmail()
和user.$update()
)。
$resource设置对象
$resource
设置对象和$http
设置对象十分相似,仅有少量的不同。 对象中的值,也就是动作,是资源对象中某个方法的名字。它可以包含以下键。
- 1.method(字符串) :
method
指的是我们想要用来发送HTTP请求的方法。它必须是以下值之一:GET
、DELETE
、JSONP
、POST
、PUT
。 - 2.url(字符串):一个URL,用来覆盖为该方法的具体路由设置的URL。
- 3.params(字符串map或对象):这个键中包含了此动作可选的预绑定参数。如果任何一个值都是函数,那么每当我们需要读取一个请求的参数时,它就会被执行一次。
- 4.isArray(布尔型) :如果
isArray
被设置为true
,那么这个动作返回的对象会以数组的形式返回。
5.transformRequest(函数或函数数组):这个函数或函数数组用来对HTTP请求的请求体和头信息进行转换,并返回转换后的版本。通常用来进行序列化。
var User = $resource('/api/users/:id',{
id: '@'
}, {
sendEmail: {
method: 'PUT',
transformRequest: function(data, headerFn) {
// 返回修改后的请求数据
return JSON.stringify(data);
}
}
});
6.transformResponse(函数或函数数组)
这个函数或函数数组用来对HTTP响应体和头信息进行转换,并返回转换后的版本。通常用来进行反序列化。
var User = $resource('/api/users/:id',{
id:'@'
}, {
sendEmail: {
method: 'PUT',
transformResponse: function(data, headerFn)
{
// Return modified data for the response
return JSON.parse(data);
}
}
});
- 7.cache(布尔型或缓存对象)
如果cache
属性被设置为true
,那么AngularJS会用默认的$http
缓存对GET请求进行缓存。
如果cache
属性被设置为$cacheFactory
对象的一个实例,那么这个对象会用来对GET请求进行缓存。
如果cache
属性被设置为false
,那么$resource
服务所发送的请求不会被缓存。 - 8.timeout(数值型或promise对象)
如果timeout
被设置为一个数值,那么请求将会在推迟timeout
指定的毫秒数后再发送。
如果被设置为一个promise
对象,那么当该promise
对象被resolve
时,请求会被中止。 - 9.withCredentials(布尔型)
如果该属性被设置为true
,那么XHR请求对象中会设置withCredentials
标记。
默认情况下,CORS请求不会发送cookie
,而withCredentials
标记会在请求中加入Access- Control-Allow-Credentials
头,这样请求就会携带目标域的cookie
。 - 10.responseType(字符串)
responseType
选项会在请求中设置XMLHttpRequestResponseType
属性。我们可以使用以下HTTP请求类型之一:- " "(字符串,默认)
- "arraybuffer"(ArrayBuffer)
- "blob"(blob对象)
- "document"(HTTP文档)
- "json"(从JSON对象解析而来的JSON字符串)
- "text"(字符串)
- "moz-blob"(Firefox的接收进度事件)
- "moz-chunked-text"(文本流)
- "moz-chunked-arraybuffer"(ArrayBuffer流)
- interceptor(对象)
拦截器属性有两个可选的方法:response
或responseError
。这些拦截器像普通的$http
拦截器一样,由$http
请求对象调用。
- interceptor(对象)
$resource服务
我们可以将$resource
服务当作自定义服务的基础。创建自定义服务给了我们对应用进行高 度自定义的能力,可以对远程服务通信进行抽象,并且从控制器和视图中解耦出来。
要创建一个封装$resource
的服务,需要将$resource
的服务注入到我们用来封装的服务对象中,并像平时一样调用其中的方法。
angular.module('myApp', ['ngResource']) .factory('UserService', [
'$resource', function($resource) {
return $resource('/api/users/:id', {
id: '@'
}, {
update: {
method: 'PUT'
}
});
}]);
$resourceAPI
通过$resource()
方法来使用$resource
服务。这个方法可以接受三个参数。
- url(字符串)
我们在这里传入一个包含所有参数的,用来定位资源的参数化URL字符串模板(参数以:符号为前缀)。对URL中的每个参数,都可以通过它们的名字来为其赋值:
$resource('/api/users/:id.:format', {
format: 'json',
id: '123'
});
这里需要注意,如果:
之前的参数是空的(上面例子中的:id
),那么URL中的这部分会被压 缩成一个.
符号。
如果我们使用的服务器要求在URL中输入端口号,例如http://localhost:3000
, 我们必须对URL进行转义 。 这种情况下URL规则看起来是这样的:
$resource('http://localhost\\:3000/api/users/:id.json')。
- paramDefaults(可选,对象)
第二个参数中包含了发送请求时URL中参数的默认值。对象中的键会与参数名进行匹配。如果我们传入了一个没有在URL中设置过的参数,那它会以普通的查询字符串的形式被发送。
例如,如果URL字符串具有/api/users/:id
这样的签名,并且我们将默认值设置为{id:'123',name:'Ari'}
,那么URL最终会被转换成/api/users/123?name=Ari
。
这里可以像上面一样硬编码一个默认值来传入一个静态值,也可以设置它从一个数据对象中读取动态值。
如果要设置动态值,需要在值之前加上@
字符作为前缀。 - actions(可选,对象)
动作对象是具有自定义动作,并且可以对默认的资源动作进行扩展的hash
对象。
在这个对象中,对象的键就是自定义动作的名字,而$http
设置对象的值会对URL中相应的参数进行替换。
例如,我们可以用如下形式在资源上定义一个新的update动作:
$resource('/api/users/:id.:format', {
format: 'json',
id: '123'
}, {
update: {
method: 'PUT'
}
});