Vue.js系列之vue-resource（6）

说明：

我们项目现在用的是：vue2.0 + vue-cli + webpack + vue-router2.0 + vue-resource1.0.3
如果大家在实践的过程中与本文所说的内容有较大区别的话看看是不是版本问题。
本文是一系列文章，在我对Vue有了更深刻的理解认识之后会对文章及时进行修改或更正，欢迎大家批评指出错误。以下是已完成的文章列表。

1. Vue.js系列之项目搭建（1）
2. Vue.js系列之项目结构说明（2）
3. Vue.js系列之vue-router(上)（3）
4. Vue.js系列之vue-router(中)（4）
5. Vue.js系列之vue-router(下)（5）

---

概述

前面五篇文章我们已经从简单的项目搭建到清楚项目结构，以及详细介绍了vue-router官方插件，现在我们要实现项目的动态数据交互，就要用到接口请求插件vue-resource，它不是Vue官方维护的插件，但是使用是最多的，它可以通过XMLHttpRequest或JSONP发起请求并处理响应。vue-resource有非常简洁的API，还提供了非常有用的inteceptor（拦截器）功能，使用inteceptor可以在请求前和请求后附加一些行为，比如使用inteceptor在ajax请求时显示loading界面。下面我们就要了解一下吧。
项目地址：https://github.com/pagekit/vue-resource

一.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，或者在请求失败时，提供共通的处理方式。

二.vue-resource基本使用方法

1.安装与引用

NPM：$ npm install vue-resource --save

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

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

2.语法

引入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) => {
    // 响应错误回调
});

关于options对象和response对象的说明可以参见官方文档。

emulateHTTP的作用

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

Vue.http.options.emulateHTTP = true;

emulateJSON的作用

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

Vue.http.options.emulateJSON = true;

3.使用

我是用传统的函数写法，在各个组件的Vue实例中使用$http，然后将成功和错误回掉单独拿出来声明。在methods对象中写好函数逻辑处理，然后在mounted()函数中调用它，这样渲染这个组件的时候就会发送请求。当然，请求的地址和参数已经在data()函数中声明，请求方式根据具体需求来。

在使用的时候遇到一个小坑,这个$http请求和jquery的ajax还是有点区别，这里的post的data默认不是以form data的形式，而是request payload。解决起来也很简单，将emulateJSON 属性设置为true即可。

Vue.http.options.emulateJSON = true

按照API说明文档，我请求回来的response只需要调用json()方法就可以返回JSON对象，然而返回却是Promise对象。看图。我不太了解Promise，查了资料目前也没整明白，文档上面type是Promise，但是描述里面又说是转化成JSON对象。反正最后我的代码里是转化了一下的，拿到JSON对象了我们就可以进行其他逻辑处理了。

var data = JSON.parse(response.body);

4.inteceptor（拦截器）

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

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

5.proxy（代理）巨坑

场景：在本地serve发送API接口请求，那我们得用跨域了吧，jsonp，但是我们后端说跨域不安全，接口没有实现跨域请求，就算开发时候跨域请求成功，那上线时不可能去修改所有的请求方式吧。于是就各种搜索解决方案，在打算用Nginx代理的时候，发现了Vue.js的webpack模板中自带了一个代理，泪奔，赶紧修改。
文档地址：https://vuejs-templates.github.io/webpack/proxy.html

三.总结

本文主要分享了vue-resource插件的安装与使用，以及在使用的过程中遇到的一些问题及处理方法，其中我认为比较重要的点，也就是在开发过程中可能遇到的坑而且在没人告知的情况下最容易卡住的地方已经在3.使用和5.proxy（代理）巨坑 中说明了，文中若有错误，请大家指出。

整个项目从基本构建到vue-router插件到vue-resource已经可以实现整个项目的架构了，Vuex在这里不适用也不做介绍，后期有机会将新增分享。接下来我将就项目中某些具体的功能实现和一些Vue的使用技巧上做一些分享。

参考文章：http://www.cnblogs.com/keepfool/p/5657065.html