React 项目中 axios 的封装和API接口的管理

前言

在react项目中，和后台交互获取数据这块，咱们一般使用的是axios库，它是基于promise的http库，可运行在浏览器端和node.js中。他有不少优秀的特性，例如拦截请求和响应、取消请求、转换json、客户端防护XSRF等。若是还对axios不了解的，能够移步axios文档。

安装

//使用npm安装
npm install axios; 
//使用yarn安装
yarn add axios
复制代码

引入

在项目根目录中，新建一个request文件夹，而后在里面新建一个index.js和一个api.js文件。index.js文件用来封装咱们的axios，api.js用来统一管理咱们的接口。

//在index.js中引入axios
import axios from 'axios';
//引入qs模块，用来序列化post类型的数据
import QS from 'qs';
//antd的message提示组件，你们可根据本身的ui组件更改。
import { message } from 'antd'
复制代码

环境的切换

咱们的项目环境可能有开发环境、测试环境和生产环境。咱们经过node的环境变量来匹配咱们的默认的接口url前缀。这里须要node的全局变量process,process.env.NODE_ENV能够区分是开发环境仍是生产环境。

//保存环境变量
const isPrd = process.env.NODE_ENV == 'production';

//区分开发环境仍是生产环境基础URL
export const basciUrl = isPrd ? 'https://www.production.com' : 'http://www.development.com'
复制代码

这里导出基础URL是为了防止有其余地方用到资源不同，须要区分生产环境仍是开发环境，导入就直接能够用了。

请求拦截

咱们在发送请求前能够进行一个请求的拦截，为何要拦截呢，咱们拦截请求是用来作什么的呢？好比，有些请求是须要用户登陆以后才能访问的，或者post请求的时候，咱们须要序列化咱们提交的数据。这时候，咱们能够在请求被发送以前进行一个拦截，从而进行咱们想要的操做。

//设置axios基础路径
const service = axios.create({
  baseURL: basicUrl
})
// 请求拦截器
service.interceptors.request.use(config => { 
  // 每次发送请求以前本地存储中是否存在token，也能够经过Redux这里只演示经过本地拿到token
  // 若是存在，则统一在http请求的header都加上token，这样后台根据token判断你的登陆状况
  // 即便本地存在token，也有可能token是过时的，因此在响应拦截器中要对返回状态进行判断 
  const token = window.localStorage.getItem('userToken') || window.sessionStorage.getItem('userToken');
  //在每次的请求中添加token
  config.data = Object.assign({}, config.data, {
    token: token,
  })
  //设置请求头
  config.headers = {
    'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8'
  }
  config.data = QS.stringify(config.data)
  return config
}, error => { 
    return error;
})
复制代码

这里说一下token，通常是在登陆完成以后，将用户的token经过localStorage或者sessionStorage存在本地，而后用户每次在进入页面的时候（即在main.js中），会首先从本地存储中读取token，若是token存在说明用户已经登录过，则更新Redux中的token状态。而后，在每次请求接口的时候，都会在请求的header中携带token，后台人员就能够根据你携带的token来判断你的登陆是否过时，若是没有携带，则说明没有登陆过。

响应拦截

// 响应拦截器
service.interceptors.response.use(response => {
  //根据返回不一样的状态码作不一样的事情
  // 这里必定要和后台开发人员协商好统一的错误状态码
  if (response.code) {
    switch (response.code) {
      case 200:
        return response.data;
      case 401:
        //未登陆处理方法
        break;
      case 403:
        //token过时处理方法
        break;
      default:
        message.error(response.data.msg)
    }
  } else { 
    return response;
  }
})
//最后把封装好的axios导出
export default service
复制代码

响应拦截器很好理解，就是服务器返回给咱们的数据，咱们在拿到以前能够对他进行一些处理。例如上面的思想：若是后台返回的状态码是200，则正常返回数据，不然的根据错误的状态码类型进行一些咱们须要的错误，具体返回的状态码须要处理那些流程还须要跟后台开发人员协商。
上面的message.error()方法时我引入的antd的库提示组件，须要根据你的UI库，对应使用提示组件

api的统一管理

整齐的api就像电路板同样，即便再复杂也能很清晰整个线路。上面说了，咱们会新建一个api.js,而后在这个文件中存放咱们全部的api接口。

首先咱们在api.js中引入咱们封装的axios

//导入咱们封装好的axios 
import service from './index'
复制代码

如今，例如咱们有这样一个接口，是一个post请求：

http://www.development.com/api/v1/articleEdit
复制代码

咱们能够在api.js中这样封装：

export const apiArticleEdit = info => service.post('/api/v1/articleEdit', info);
复制代码

咱们定义了一个apiArticleEdit方法，这个方法有一个参数info，info是咱们请求接口时携带的参数对象。然后调用了咱们封装的axios方法，第一个参数是咱们的接口地址，第二个参数是apiArticleEdit的info参数，即请求接口时携带的参数对象。最后经过export导出apiArticleEdit。

而后在咱们的页面中能够这样调用咱们的api接口：

import React, { Component } from 'react'
 import { apiArticleEdit } from './request/api'
export default class App extends Component {
  componentDidMount() { 
    // 调用api接口，而且提供了两个参数
    let params = { type: 2, author: '北孤清茶' }
    apiArticleEdit(params).then(res => { 
      // 获取数据成功后的其余操做
      //.....
      console.log(res)
    })
  }
  render() {
    return (
      <div> </div>
    )
  }
}

复制代码

其余的api接口，就在api.js中继续往下面扩展就能够了。友情提示，为每一个接口写好注释哦！！！

api接口管理的一个好处就是，咱们把api统一集中起来，若是后期须要修改接口，咱们就直接在api.js中找到对应的修改就行了，而不用去每个页面查找咱们的接口而后再修改会很麻烦。关键是，万一修改的量比较大。还有就是若是直接在咱们的业务代码修改接口，一不当心还容易动到咱们的业务代码形成没必要要的麻烦。

好了，最后把完成的axios封装代码奉上。

//在index.js中引入axios
import axios from 'axios';
//引入qs模块，用来序列化post类型的数据
import QS from 'qs';
//antd的message提示组件，你们可根据本身的ui组件更改。
import { message } from 'antd'

//保存环境变量
const isPrd = process.env.NODE_ENV == 'production';

//区分开发环境仍是生产环境基础URL
export const basciUrl = isPrd ? 'https://www.production.com' : 'http://www.development.com'

//设置axios基础路径
const service = axios.create({
  baseURL: basicUrl
})

// 请求拦截器
service.interceptors.request.use(config => { 
  // 每次发送请求以前本地存储中是否存在token，也能够经过Redux这里只演示经过本地拿到token
  // 若是存在，则统一在http请求的header都加上token，这样后台根据token判断你的登陆状况
  // 即便本地存在token，也有可能token是过时的，因此在响应拦截器中要对返回状态进行判断 
  const token = window.localStorage.getItem('userToken') || window.sessionStorage.getItem('userToken');
  //在每次的请求中添加token
  config.data = Object.assign({}, config.data, {
    token: token,
  })
  //设置请求头
  config.headers = {
    'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8'
  }
  //序列化请求参数，否则post请求参数后台接收不正常
  config.data = QS.stringify(config.data)
  return config
}, error => { 
    return error;
})

// 响应拦截器
service.interceptors.response.use(response => {
  //根据返回不一样的状态码作不一样的事情
  // 这里必定要和后台开发人员协商好统一的错误状态码
  if (response.code) {
    switch (response.code) {
      case 200:
        return response.data;
      case 401:
        //未登陆处理方法
        break;
      case 403:
        //token过时处理方法
        break;
      default:
        message.error(response.data.msg)
    }
  } else { 
    return response;
  }
})
//最后把封装好的axios导出
export default service
复制代码