vue-resource基本使用方法

一、vue-resource 特点

  1、体积小:vue-resource 非常小巧,在压缩以后只有大约 12KB,服务端启用 gzip 压缩后只有 4.5KB 大小,这远比 jQuery 的体积要小得多。

  2、支持主流浏览器:和 Vue.js 一样,vue-resource 除了不支持 IE 9 以下的浏览器,其他主流的浏览器都支持

  3、支持 Promise API 和 URI Templates:Promise 是 ES6 的特性,Promise 的中文含义为“先知”,Promise 对象用于异步计算。 URI Templates 表示 URI 模板,有些类似于 ASP.NET MVC 的路由模板

  4、支持拦截器:拦截器是全局的,拦截器可以在请求发送前和发送请求后做一些处理。 拦截器在一些场景下会非常有用,比如请求发送前在 headers 中设置 access_token,或者在请求失败时,提供共通的处理方式。

二、安装与引用

  NPM: npm install vue-resource --save-dev

/*引入 Vue 框架*/
import Vue from 'vue'
/*引入资源请求插件*/
import VueResource from 'vue-resource'

/使用 VueResource 插件/
Vue.use(VueResource)

  src 引入,就直接引入文件即可,注意在要 vue 之后引入

三、语法

  引入 vue-resource 后,可以基于全局的 Vue 对象使用 http,也可以基于某个 Vue 实例使用 http

// 基于全局 Vue 对象使用 http
Vue.http.get('/someUrl', [options]).then(successCallback, errorCallback);
Vue.http.post('/someUrl', [body], [options]).then(successCallback, errorCallback);

// 在一个 Vue 实例内使用 $http
this.$http.get('/someUrl', [options]).then(successCallback, errorCallback);
this.$http.post('/someUrl', [body], [options]).then(successCallback, errorCallback);

  在发送请求后,使用 then 方法来处理响应结果,then 方法有两个参数,第一个参数是响应成功时的回调函数,第二个参数是响应失败时的回调函数。

  then 方法的回调函数也有两种写法,第一种是传统的函数写法,第二种是更为简洁的 ES 6 的 Lambda 写法:

// 传统写法
this.$http.get('/someUrl', [options]).then(function(response){
    // 响应成功回调
}, function(response){
    // 响应错误回调
});

// Lambda 写法
this.$http.get('/someUrl', [options]).then((response) => {
// 响应成功回调
}, (response) => {
// 响应错误回调
});

  1、支持的 HTTP 方法:vue-resource 的请求 API 是按照 REST 风格设计的,它提供了 7 种请求 API:

  • get(url, [options])
  • head(url, [options])
  • delete(url, [options])
  • jsonp(url, [options])
  • post(url, [body], [options])
  • put(url, [body], [options])
  • patch(url, [body], [options])

  除了 jsonp 以外,另外 6 种的 API 名称是标准的 HTTP 方法。当服务端使用 REST API 时,客户端的编码风格和服务端的编码风格近乎一致,这可以减少前端和后端开发人员的沟通成本。

  2、options 对象

  发送请求时的 options 选项对象包含以下属性:

  3、emulateHTTP 的作用

  如果 Web 服务器无法处理 PUT, PATCH 和 DELETE 这种 REST 风格的请求,你可以启用 enulateHTTP 现象。启用该选项后,请求会以普通的 POST 方法发出,并且 HTTP 头信息的 X-HTTP-Method-Override 属性会设置为实际的 HTTP 方法。

Vue.http.options.emulateHTTP = true;

  4、emulateJSON 的作用

  如果 Web 服务器无法处理编码为 application/json 的请求,你可以启用 emulateJSON 选项。启用该选项后,请求会以 application/x-www-form-urlencoded 作为 MIME type,就像普通的 HTML 表单一样。

Vue.http.options.emulateJSON = true;

四、使用实例

var demo = new Vue({
    el: '#app',
    data: {
        gridColumns: ['customerId', 'companyName', 'contactName', 'phone'],
        gridData: [],
        apiUrl: 'http://192.168.118.221:8080/api/customers'
    },
    mounted: function() {
        this.getCustomers() },
    methods: {getCustomers: function() {
            this.$http.get(this.apiUrl).then((response) => {
                this.$set('gridData', response.data)},(response) => {
                console.log("出错了");}).catch(function(response) {console.log(response)
            })}}
});
  这段程序的 then 方法里提供了successCallbackerrorCallback。catch 方法用于捕捉程序的异常,catch 方法和errorCallback是不同的,errorCallback只在响应失败时调用,而 catch 则是在整个请求到响应过程中,只要程序出错了就会被调用。
  在 then 方法的回调函数内,你也可以直接使用 this,this 仍然是指向 Vue 实例的。为了减少作用域链的搜索,建议使用一个局部变量来接收 this。

五、使用 resource 服务

  vue-resource提供了另外一种方式访问HTTP——resource服务,resource服务包含以下几种默认的action

get: {method: 'GET'}, 
save: {method: 'POST'}, 
query: {method: 'GET'}, 
update: {method: 'PUT'}, 
remove: {method: 'DELETE'}, 
delete: {method: 'DELETE'}

  1、resource 对象也有两种访问方式

//全局访问
Vue.resource

//局部访问
this.$resource

  可以结合 URI Template一起使用,以下示例的apiUrl都设置为{/id}了:

apiUrl: 'http://211.149.193.19:8080/api/customers{/id}'

  {/id} 相当于一个占位符,当传入实际的参数时该占位符会被替换。例如,{ id: vm.item.customerId}中的vm.item.customerId为 12,那么发送的请求 URL 为:http://211.149.193.19:8080/api/customers/12

  2、使用实例

//使用 get 方法发送 GET 请求,下面这个请求没有指定 {/id}
getCustomers: function() {
    var resource = this.$resource(this.apiUrl),
        vm = this;
    resource.get().then((response) => {
        vm.$set('gridData', response.data);}).catch(function(response) {console.log(response);
    })
}
//使用 save 方法发送 POST 请求,下面这个请求没有指定 {/id}
createCustomer: function() {
    var resource = this.$resource(this.apiUrl),
        vm = this;
    resource.save(vm.apiUrl, vm.item).then((response) => {
        vm.$set('item', {});
        vm.getCustomers();});
    this.show = false;
}

//使用 update 方法发送 PUT 请求,下面这个请求指定了 {/id}
updateCustomer: function() {
var resource = this.$resource(this.apiUrl),
vm
= this;
resource.update({
id: vm.item.customerId
}, vm.item).then((response)
=> {
vm.getCustomers();
})
}

六、使用 inteceptor

  拦截器可以在请求发送前和发送请求后做一些处理。在 response 返回给 successCallback 或 errorCallback 之前,你可以修改 response 中的内容,或做一些处理。 例如,响应的状态码如果是 404,你可以显示友好的 404 界面。再比如我们就用拦截器做了登录处理,所以请求发送之前都要通过拦截器验证当前用户是否登陆,否则提示登录页面。

Vue.http.interceptors.push(function(request, next) {
    // ...
    // 请求发送前的处理逻辑
    // ...
    next(function(response) {
        // ...
        // 请求发送后的处理逻辑
        // ...
        // 根据请求的状态,response 参数会返回给 successCallback 或 errorCallback
        return response
    })})

  1、拦截器实例:

  (1)为请求添加 loading 效果

  通过inteceptor,我们可以为所有的请求处理加一个loading:请求发送前显示loading,接收响应后隐藏 loading。

  具体步骤如下:

//1、添加一个 loading 组件
<template id='loading-template'>
    <div class='loading-overlay'></div>
</template>

//2、将 loading 组件作为另外一个 Vue 实例的子组件
var help = new Vue({
el:
'#help',
data: {
showLoading:
false
},
components: {
'loading': {
template:
'#loading-template',
}
}
})

//3、将该 Vue 实例挂载到某个 HTML 元素
<div id='help'>
<loading v-show='showLoading'></loading>
</div>

//4、添加 inteceptor
Vue.http.interceptors.push((request, next) => {
loading.show
= true;
next((response)
=> {
loading.show
= false;
return response;
});
});

  我们继续,当用户在画面上停留时间太久时,画面数据可能已经不是最新的了,这时如果用户删除或修改某一条数据,如果这条数据已经被其他用户删除了,服务器会反馈一个 404 的错误,但由于我们的 put 和 delete 请求没有处理errorCallback,所以用户是不知道他的操作是成功还是失败了。你问我为什么不在每个请求里面处理errorCallback,这是因为我比较懒。这个问题,同样也可以通过inteceptor解决。

  (2)为请求添加共同的错误处理方法

//1、继续沿用上面的 loading 组件,在 #help 元素下加一个对话框
<div id='help'>
    <loading v-show='showLoading' ></loading>
    <modal-dialog :show='showDialog'>
        <header class='dialog-header' slot='header'>
            <h3 class='dialog-title'>Server Error</h3>
        </header>
        <div class='dialog-body' slot='body'>
            <p class='error'>Oops,server has got some errors, error code: {{errorCode}}.</p>
        </div>
    </modal-dialog>
</div>

//2、给 help 实例的 data 选项添加两个属性
var help = new Vue({
el:
'#help',
data: {
showLoading:
false,
showDialog:
false,
errorCode:
''
},
components: {
'loading': {
template:
'#loading-template',
}
}
})

//3、修改 inteceptor
Vue.http.interceptors.push((request, next) => {
help.showLoading
= true;
next((response)
=> {
if(!response.ok){
help.errorCode
= response.status;
help.showDialog
= true;
}
help.showLoading
= false;
return response;
});
});

  vue-resource是一个非常轻量的用于处理 HTTP 请求的插件,它提供了两种方式来处理 HTTP 请求:

  (1)使用 Vue.http 或this.$http

  (2)使用Vue.resourcethis.$resource

  这两种方式本质上没有什么区别,阅读vue-resource的源码,你可以发现第 2 种方式是基于第 1 种方式实现的。

  提供了拦截器:inteceptor可以在请求前和请求后附加一些行为,这意味着除了请求处理的过程,请求的其他环节都可以由我们来控制。