后端开发者的Vue学习之路(五)
目录
首发日期:2019-01-29
作者:http://www.cnblogs.com/progor/
上节内容回顾
- npm(介绍,安装,命令)
- 基于npm的hello world(学会如何初始化一个vue项目,并启动项目)
- 项目结构分析(重点是src目录)
- 用法迁移(根实例怎么创建,页面是怎么渲染的,组件怎么注册,)
- 小提醒(语法注意,和‘@’)
- 单文件组件
- 路由(开启路由,定义路由,带参路由,使用路由(router-link,router-view),嵌套路由,嵌套路由,命名路由,编程式路由,)
- vuex(actioins,mutaions,state,怎么创建store,怎么读取数据,怎么修改数据)
使用第三方组件库
网上有很多vue的第三方组件库,为了简化开发,我们通常都会使用第三方的组件库。
下面以导入element ui 组件库为例:
首先,安装element ui模块,并把依赖添加到package.json中:npm install element-ui --save
然后,如果你是要在整个项目中都用到element ui的话,那就在main.js中添加下列代码,这样就可以在所有的组件中使用elmenent ui中的所有组件了:
import elementui from 'element-ui' import 'element-ui/lib/theme-chalk/index.css' vue.use(elementui)
如果你仅仅想使用某个组件的话,可以仅仅在某个组件中使用import来导入element ui的组件。
如何发起请求
我们搭建了一个页面后,通常都希望从后端接口获取数据来渲染页面。现在推荐的发起请求的方式是使用axios来发起请求。
首先,我们要安装axiosnpm install axios
然后在组件中使用axios来发请求:
<template> <div class='hello'> 接受到的数据:{{msg}} <button @click="getlist">获取数据</button> </div> </template> <script> import axios from 'axios' export default { name: 'hello', data () { return { msg: '' } }, methods: { getlist () { axios.get('https://api.coindesk.com/v1/bpi/currentprice.json').then(response => { this.msg = response }) } } } </script>
上面只演示了axios.get,类似的,还有axios.post,axios.put等等请求方法。
请求错误处理
如果请求失败了,那么不会跳到then,而是交给catch来处理,catch里面的第一个参数就是错误信息:
axios .get('https://api.coindesk.com/v1/bpi/currentprice.json') .then(response => (this.info = response.data.bpi)) .catch(error => console.log(error))
请求带参
以get的方式带参:
axios.get('https://api.coindesk.com/v1/bpi/currentprice.json',{params: {id: 12345}}) .then(response => { this.msg = response })
以post的方式带参:
axios.post('/user', {firstname: 'fred', lastname: 'flintstone'}) .then((response) => { console.log(response) }) .catch((error) => { console.log(error) })
封装处理
在上面的例子中,我们可以看到如果我们想要发送请求,将要在axios.xxx()的参数中写很长的代码。该怎么优化呢?
请求的配置
其实也可以使用axios()来发起请求,axios里面的参数是关于请求的配置,例如:
var request = { method: 'post', url: '/user', data: {firstname: 'fred', lastname: 'flintstone'} } axios(request).then(response => (this.msg = response)) .catch(error => { console.log(error) })
贴一下可以设置的配置:
{ // `url` 是用于请求的服务器 url url: '/user', // `method` 是创建请求时使用的方法 method: 'get', // 默认是 get // `baseurl` 将自动加在 `url` 前面,除非 `url` 是一个绝对 url。 // 它可以通过设置一个 `baseurl` 便于为 axios 实例的方法传递相对 url baseurl: 'https://some-domain.com/api/', // `transformrequest` 允许在向服务器发送前,修改请求数据 // 只能用在 'put', 'post' 和 'patch' 这几个请求方法 // 后面数组中的函数必须返回一个字符串,或 arraybuffer,或 stream transformrequest: [function (data) { // 对 data 进行任意转换处理 return data; }], // `transformresponse` 在传递给 then/catch 前,允许修改响应数据 transformresponse: [function (data) { // 对 data 进行任意转换处理 return data; }], // `headers` 是即将被发送的自定义请求头 headers: {'x-requested-with': 'xmlhttprequest'}, // `params` 是即将与请求一起发送的 url 参数 // 必须是一个无格式对象(plain object)或 urlsearchparams 对象 params: { id: 12345 }, // `paramsserializer` 是一个负责 `params` 序列化的函数 // (e.g. https://www.npmjs.com/package/qs, http://api.jquery.com/jquery.param/) paramsserializer: function(params) { return qs.stringify(params, {arrayformat: 'brackets'}) }, // `data` 是作为请求主体被发送的数据 // 只适用于这些请求方法 'put', 'post', 和 'patch' // 在没有设置 `transformrequest` 时,必须是以下类型之一: // - string, plain object, arraybuffer, arraybufferview, urlsearchparams // - 浏览器专属:formdata, file, blob // - node 专属: stream data: { firstname: 'fred' }, // `timeout` 指定请求超时的毫秒数(0 表示无超时时间) // 如果请求话费了超过 `timeout` 的时间,请求将被中断 timeout: 1000, // `withcredentials` 表示跨域请求时是否需要使用凭证 withcredentials: false, // 默认的 // `adapter` 允许自定义处理请求,以使测试更轻松 // 返回一个 promise 并应用一个有效的响应 (查阅 [response docs](#response-api)). adapter: function (config) { /* ... */ }, // `auth` 表示应该使用 http 基础验证,并提供凭据 // 这将设置一个 `authorization` 头,覆写掉现有的任意使用 `headers` 设置的自定义 `authorization`头 auth: { username: 'janedoe', password: 's00pers3cret' }, // `responsetype` 表示服务器响应的数据类型,可以是 'arraybuffer', 'blob', 'document', 'json', 'text', 'stream' responsetype: 'json', // 默认的 // `xsrfcookiename` 是用作 xsrf token 的值的cookie的名称 xsrfcookiename: 'xsrf-token', // default // `xsrfheadername` 是承载 xsrf token 的值的 http 头的名称 xsrfheadername: 'x-xsrf-token', // 默认的 // `onuploadprogress` 允许为上传处理进度事件 onuploadprogress: function (progressevent) { // 对原生进度事件的处理 }, // `ondownloadprogress` 允许为下载处理进度事件 ondownloadprogress: function (progressevent) { // 对原生进度事件的处理 }, // `maxcontentlength` 定义允许的响应内容的最大尺寸 maxcontentlength: 2000, // `validatestatus` 定义对于给定的http 响应状态码是 resolve 或 reject promise 。如果 `validatestatus` 返回 `true` (或者设置为 `null` 或 `undefined`),promise 将被 resolve; 否则,promise 将被 rejecte validatestatus: function (status) { return status >= 200 && status < 300; // 默认的 }, // `maxredirects` 定义在 node.js 中 follow 的最大重定向数目 // 如果设置为0,将不会 follow 任何重定向 maxredirects: 5, // 默认的 // `httpagent` 和 `httpsagent` 分别在 node.js 中用于定义在执行 http 和 https 时使用的自定义代理。允许像这样配置选项: // `keepalive` 默认没有启用 httpagent: new http.agent({ keepalive: true }), httpsagent: new https.agent({ keepalive: true }), // 'proxy' 定义代理服务器的主机名称和端口 // `auth` 表示 http 基础验证应当用于连接代理,并提供凭据 // 这将会设置一个 `proxy-authorization` 头,覆写掉已有的通过使用 `header` 设置的自定义 `proxy-authorization` 头。 proxy: { host: '127.0.0.1', port: 9000, auth: : { username: 'mikeymike', password: 'rapunz3l' } }, // `canceltoken` 指定用于取消请求的 cancel token // (查看后面的 cancellation 这节了解更多) canceltoken: new canceltoken(function (cancel) { }) }
axios实例
虽然使用了配置之后不用把参数都写在axios.xxx()里面了,但是这样好像每一次都要定义一个关于请求参数的配置。有些数据我是不想重新定义的,能不能再优化呢?我们可以使用axios实例提前来读取一部分共用配置,然后后续再传入的配置的会与先前的配置进行合并。
【下面以提前配置baseurl,后面的配置传入url为例,如果最终的请求是baseurl和url的拼接结果(通过监听浏览器网络请求得到),那么就说明配置合并成功】
var instance = axios.create({ baseurl: 'https://www.baidu.com' }) var request = { method: 'get', url: '/s', params: {wd: 'vue'} } // 当传入了url参数的时候,才会发起请求,所以虽然都是传配置,但上面的那个并没有发起请求 instance(request) .then(response => { console.log(response) }) .catch(error => { console.log(error) })
实现调用自定义函数来发起请求
像上面,我们都是直接调用axios来发起请求的,这可能会导致一些问题,例如在多个组件中都需要发起针对同一个url的请求的时候,如果按照上面直接axios来发起请求的话,那么就会造成代码冗余(想象一下,针对同一个url请求,却要在不同组件中都写一个axios.xxx)。为了减少代码冗余,我们通常都会进行代码抽取,我们把重复的代码都抽取到函数中。
抽取axios请求到函数
上面的例子只是用作演示如何把发起请求的代码抽取到函数中。事实上,上面的抽取并没有完全抽取干净,另一个组件中发起请求时,也要重新定义函数。所以我们要想办法把上面的函数抽取到一个js文件中,抽取到js文件后,我们就可以通过import来导入了。
抽取函数到js文件
首先, 在src下,我们新建一个文件夹api,在api下,我们创建一个index.js【由于一般会有很多个api请求,为了分文件管理api,我们通常会根据api的功能来把发起请求的函数划分到不同的文件中,所以我们可能有时候会创建类似user.js这样命名的文件来存储发起请求的函数。这里由于用于演示,所以命名为index.js】
然后,在index.js中添加下列代码:
import axios from 'axios' const request = axios.create({ baseurl: 'http://www.xxxx.com' }) export default function getuserlist (params) { return request({ url: '/getuserlist', method: 'get', params: params }) } // 可以有多个export default function xxxx
最后,在组件中导入getuserlist这个函数,并发起请求:
抽取axios对象到js文件
【如果你有留心的话,你应该感觉到上面的axios对象应该也要进行抽取,因为如果有个js文件的话,会导致创建axios对象的这部分代码赘余了,我们可以把这部分的代码抽取到src/plugin/axios的index.js中】
import axios from 'axios' const request = axios.create({ baseurl: 'http://www.xxxx.com' }) export default request // 记得导出
不要忘了,api中也要对应修改:
响应的数据
请求响应后,响应的数据都会封装到response中,其中response.data是服务器返回的响应信息,response.status是响应码,具体如下。
{ // `data` 由服务器提供的响应 data: {}, // `status` 来自服务器响应的 http 状态码 status: 200, // `statustext` 来自服务器响应的 http 状态信息 statustext: 'ok', // `headers` 服务器响应的头 headers: {}, // `config` 是为请求提供的配置信息 config: {} }
所以请求返回后,我们可以通过response.xxx来获取响应情况。
拦截器
- 拦截器用于拦截发起的请求或用于拦截返回的响应。
- 为什么需要拦截器呢?例如,假如某个请求需要带指定的请求头才能请求成功,我们必须要处理一下请求的信息才能够请求成功,这时候我们就可以把请求交给拦截器去处理,使用拦截器来加上请求头是很常见的操作。【加请求头其实我们也可以手动做,为什么要交给拦截器呢?因为拦截器是拦截所有请求,它能给每一个请求都加上头,如果交给我们自己做,那就很累了。】
- 所以,拦截器可以拦截发起的请求来添加我们需要的数据;拦截器也可以拦截返回的响应,来过滤响应(比如服务器返回的只有一个状态码,那么拦截器可以根据状态码来确认“错误信息”,其实catch(error)中error的原生数据是比较不友好的,所以我们通常都会使用拦截器来“翻译”返回的响应)。
拦截请求
拦截器是基于axios实例来添加的。我们可以使用如下代码来添加一个请求拦截器:
const request = axios.create({ baseurl: 'https://www.xxxx.com' }) request.interceptors.request.use((config) => { // config是请求的配置 // 这里写在发送请求之前做些什么,我们这里尝试加一个请求头 config.headers['access-token'] = '123456' console.log('发起请求了') return config }, (error) => { // 这里写对请求错误做些什么 return promise.reject(error) })
拦截响应
request.interceptors.response.use((response) => { // 对响应数据做点什么 console.log('请求返回响应了' + response) return response }, (error) => { // 对响应错误做点什么 return promise.reject(error) })
补充:
- 如果想了解更多,可以查看
上一篇: vue下拉显示返回顶部(淡入淡出)