Vue学习笔记（二）------axios学习

时间  2019-12-04
标签 vue 学习 笔记 axios 繁體版
原文   原文链接

axios 是一个基于 promise 的 HTTP 库，能够用在浏览器和 node.js 中。

axios的功能和特征：
  • 从浏览器中建立XMLHttpRequests
  • 从node.js中建立http请求
  • 支持PromiseAPI
  • 拦截请求和响应
  • 转换请求数据和响应数据
  • 取消请求
  • 自动转化JSON数据
  • 客户端支持防护XSRF
在项目中安装axois

使用npmjava

npm   install  axios --save
复制代码

使用cdnnode

<script src="https://unpkg.com/axios/dist/axios.min.js"></script>
复制代码
使用demo

  • 执行GET请求，当执行GET方式时，若是携带请求参数，请求参数能够有两种方式：react

    axios.get('/user?ID=12121').then((response)=> {
    //response
}).catch((error)=> {
    //error
});
或者
axios.get('/user',{
    params: {
        ID: 12121
    }
}).then((response)=> {
    //response
}).catch((error)=> {
    //error
});
复制代码

  • 执行POST请求jquery

    axios.post('/user',{
    name: '12121'
}).then((response) => {
    //reponse
}).catch((error) => {
    //error
});
复制代码

  • 执行多个并发请求ios

function getUserAccount() {
  return axios.get('/user/12345');
}

function getUserPermissions() {
  return axios.get('/user/12345/permissions');
}

axios.all([getUserAccount(), getUserPermissions()]).then(
    axios.spread(function (acct, perms){
        //两个请求如今都执行完成
    })
);
复制代码

上面这种写法都是经过axios.get/post这种写法，这种写法稍微有点麻烦，能够经过这种写法，经过axios传递相关配置来建立请求。同时axios的默认的请求方式为GET方式。npm

axios({
    url: apiURL,
    method: method,
    timeout: timeout,
    data: data,
    params: params,
    headers: {
        'Content-Type': 'application/json',
        'token': window.sessionStore.getItem('token') || ''
    }
});
复制代码

当处理并发的方式时：json

  • axios.all(iterable)
  • axios.spread(callback)
同时axios也支持经过自定义配置建立一个axios示例

语法： axios.create([config])axios

var instance = axios.create({
   baseURL: 'https://some-domain.com/api/',
   timeout: 1000,
   headers: {'X-Custom-Header': 'foobar'} 
});
复制代码

相关的请求配置c#

这些是建立请求时能够用的配置选项。只有 url 是必需的。若是没有指定 method，请求将默认使用 get 方法。api

//'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: {
 name: '1212'       
},
    
// `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',   
复制代码
响应结构

某个请求的响应包含如下信息：

{
  // `data` 由服务器提供的响应
  data: {},

  // `status` 来自服务器响应的 HTTP 状态码
  status: 200,

  // `statusText` 来自服务器响应的 HTTP 状态信息
  statusText: 'OK',

  // `headers` 服务器响应的头
  headers: {},

  // `config` 是为请求提供的配置信息
  config: {}
}
复制代码

在实际的开发过程当中后台的接口会遵循RESTful规范，同时会本身封装数据的返回格式，例如是下面这种格式：

img

也就是说咱们取出的数据是从response.data中去拿到，而后按必定的格式取，通常后台的数据的封装格式以下：

新建一个util的包：

åœ¨è¿™é‡Œæ’å ¥å›¾ç‰‡æè¿°

MessageEntity类：

package com.ssm.util;
import lombok.Data;

@Data
public class MessageEntity<T> {
    private Integer code;
    private String msg;
    private T data;
    private Integer total;
}

复制代码

MessageCode类：

package com.ssm.util;

public enum MessageCode {

    SYSTEM_CODE(500, "系统错误");

    private Integer code;
    private String message;

    public Integer getCode() {
        return code;
    }

    public String getMessage() {
        return message;
    }

    MessageCode(Integer code, String message) {
        this.code = code;
        this.message = message;
    }
}
复制代码

ResultForma类：

package com.ssm.util;

public class ResultFormat {

    public static MessageEntity success() {
        return success(null);
    }

    public static <T> MessageEntity<T> success(T t){
        MessageEntity msg = new MessageEntity();
        msg.setCode(200);
        msg.setMsg("操做成功");
        msg.setData(t);
        return msg;
    }

    public static MessageEntity error(MessageCode message) {
        MessageEntity msg = new MessageEntity();
        msg.setCode(message.getCode());
        msg.setMsg(message.getMessage());
        return msg;
    }
}
复制代码
配置默认值
  • 全局的axios默认值
axios.defaults.baseURL = 'https://api.example.com';
axios.defaults.headers.common['Authorization'] = AUTH_TOKEN;
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';
复制代码
  • 自定义实例默认值
// 建立实例时设置配置的默认值
var instance = axios.create({
  baseURL: 'https://api.example.com'
});

// 在实例已建立后修改默认值
instance.defaults.headers.common['Authorization'] = AUTH_TOKEN;
复制代码
  • 配置的优先顺序

配置会以一个优先顺序进行合并。这个顺序是：在 lib/defaults.js 找到的库的默认值，而后是实例的 defaults 属性，最后是请求的 config 参数。后者将优先于前者。这里是一个例子：

// 使用由库提供的配置的默认值来建立实例
// 此时超时配置的默认值是 `0`
var instance = axios.create();

// 覆写库的超时默认值
// 如今，在超时前，全部请求都会等待 2.5 秒
instance.defaults.timeout = 2500;

// 为已知须要花费很长时间的请求覆写超时设置
instance.get('/longRequest', {
  timeout: 5000
});
复制代码
拦截器

在请求或响应被 then 或 catch 处理前拦截它们。

// 添加请求拦截器
axios.interceptors.request.use(function (config) {
    // 在发送请求以前作些什么
    return config;
  }, function (error) {
    // 对请求错误作些什么
    return Promise.reject(error);
  });

// 添加响应拦截器
axios.interceptors.response.use(function (response) {
    // 对响应数据作点什么
    return response;
  }, function (error) {
    // 对响应错误作点什么
    return Promise.reject(error);
  });
复制代码

若是你想在稍后移除拦截器，能够这样：

var myInterceptor = axios.interceptors.request.use(function () {/*...*/});
axios.interceptors.request.eject(myInterceptor);
复制代码
取消

可使用 CancelToken.source 工厂方法建立 cancel token，像这样：

var CancelToken = axios.CancelToken;
var source = CancelToken.source();

axios.get('/user/12345', {
  cancelToken: source.token
}).catch(function(thrown) {
  if (axios.isCancel(thrown)) {
    console.log('Request canceled', thrown.message);
  } else {
    // 处理错误
  }
});

// 取消请求（message 参数是可选的）
source.cancel('Operation canceled by the user.');
复制代码
axios源码学习

找到axios下面的lib/axios.js文件

lib/axios.js中代码建立实例代码分析：

// lib/axios.js
function createInstance(defaultConfig) {
  // 建立一个Axios实例
  var context = new Axios(defaultConfig);

  // 如下代码也能够这样实现：var instance = Axios.prototype.request.bind(context);
  // 这样instance就指向了request方法，且上下文指向context，因此能够直接以 instance(option) 方式调用 
  // Axios.prototype.request 内对第一个参数的数据类型判断，使咱们可以以 instance(url, option) 方式调用
  var instance = bind(Axios.prototype.request, context);

  // 把Axios.prototype上的方法扩展到instance对象上，
  // 这样 instance 就有了 get、post、put等方法
  // 并指定上下文为context，这样执行Axios原型链上的方法时，this会指向context
  utils.extend(instance, Axios.prototype, context);

  // 把context对象上的自身属性和方法扩展到instance上
  // 注：由于extend内部使用的forEach方法对对象作for in 遍历时，只遍历对象自己的属性，而不会遍历原型链上的属性
  // 这样，instance 就有了 defaults、interceptors 属性。（这两个属性后面咱们会介绍）
  utils.extend(instance, context);

  return instance;
}

// 接收默认配置项做为参数（后面会介绍配置项），建立一个Axios实例，最终会被做为对象导出
var axios = createInstance(defaults);
复制代码

  • 拦截器 interceptors

    拦截器分为请求拦截器（interceptors.request）和响应拦截器（interceptors.response）。

    请求拦截器(interceptors.request)是指能够拦截住每次或指定http请求，并可修改配置项 ;

    响应拦截器(interceptors.response)是指http请求后拦截，并可修改返回结果项;

  • 数据转换器

    数据转换器分为请求转换器和响应转换器，顾名思义： 请求转换器(transformRequest)是指在请求前对数据进行转换， 响应转换器(transformResponse)主要对请求响应后的响应体作数据转换。

  • http请求适配器

  • config配置项

axios流程图

img

axios多种使用方式：
  • 第1种使用方式：axios(option)
axios({
  url,
  method,
  headers,
})
复制代码
  • 第2种使用方式：axios(url[, option])
axios(url, {
  method,
  headers,
})
复制代码
  • 第3种使用方式（对于get、delete等方法）：axios[method](url[, option])
axios.get(url, {
  headers,
})
复制代码
  • 第4种使用方式（对于post、put等方法）：axios[method](url[, data[, option]])
axios.post(url, data, {
  headers,
})
复制代码
  • 第5种使用方式：axios.request(option)
axios.request({
  url,
  method,
  headers,
})
复制代码
用户配置项对象config

http请求适配器、请求地址、请求方法、请求头header、 请求数据、请求或响应数据的转换、请求进度、http状态码验证规则、超时、取消请求等。能够发现，几乎axios全部的功能都是经过这个对象进行配置和传递的， 既是axios项目内部的沟通桥梁，也是用户跟axios进行沟通的桥梁。

import axios from 'axios'

// 第1种：直接修改Axios实例上defaults属性，主要用来设置通用配置
axios.defaults[configName] = value;

// 第2种：发起请求时最终会调用Axios.prototype.request方法，而后传入配置项，主要用来设置“个例”配置
axios({
  url,
  method,
  headers,
})

// 第3种：新建一个Axios实例，传入配置项，此处设置的是通用配置
let newAxiosInstance = axios.create({
  [configName]: value,
})

复制代码
跨域携带cookie
import axios from 'axios'

axios.defaults.withCredentials = true;
复制代码
在react项目中对axios简单封装使用

命名三个文件Api.js、ApiURL.js、ApiIp.js，其中ApiIp.js是用来获取服务器ip地址的，ApiURL.js是用来拼装ip地址和接口路径的，固然这个可使用baseURL来实现也能够，即：axios.defaults.baseURL = 'api.example.com';

Api.js的实现

import axios from 'axios';
import {notification} from 'antd';
import * as ApiURL from 'src/HttpClientRequest/ApiURL';

const key = 'keepOnlyOne';

/** * 数据请求公共方法 * @param apiURL 接口请求路径 * @param configObj 用户传入配置的参数 * @returns {Promise<any>} */

function getDataFromServer(apiURL, configObj) {

    // 获取用户传入的接口配置参数
    let {
        method = 'get',
        data = {},
        timeout = 3000,
        params = {}
    } = configObj;

    return new Promise(function (resolve, reject) {
        axios({
            url: apiURL,
            method: method,
            timeout: timeout,
            data: data,
            params: params,
            headers: {
                'Content-Type': 'application/json',
                'token': window.sessionStore.getItem('token') || ''
            }
        }).then((response) => {
            if (response) {
                if (response.data && response.data.code) {
                    resolve(response);
                } else {
                    notification.error({
                        key,
                        message: '操做失败',
                        description: '数据格式有误'
                    });
                    resolve(response);
                }
            } else {
                notification.error({
                    key,
                    message: '操做失败',
                    description: '服务器错误'
                });
                resolve(response);
            }
        }).catch((error) => {
            notification.error({
                key,
                message: '操做失败',
                description: '网络异常，请稍后重试'
            });
            reject(error);
        });
    });
}


export function login(configObj) {
    return getDataFromServer(ApiURL.LOGIN, configObj);
}
复制代码

ApiURL.js

import API_IP from './ApiIp';

// 登陆接口地址
export const LOGIN = `${API_IP}/index/login`;
复制代码

ApiIp.js

// 获取当前浏览器的地址
const interfaceIp = window.location.host;
const imageAddrassIp = window.location.hostname;

// 获取当前浏览器的协议
const browserProtocol = window.location.protocol;

// 进行服务器请求地址的封装
const serverInterfaceIp = `${browserProtocol}//${interfaceIp}`;
const serverImageIp = `${browserProtocol}//${imageAddrassIp}`;

// 对外提供的请求地址(兼容生产环境和开发环境)
export const API_IP = process.env.NODE_ENV === 'development' ? 'http://121.0.0.1:8080' : serverInterfaceIp;
export const IMAGES_IP = process.env.NODE_ENV === 'development' ? 'http://121.0.0.1' : serverImageIp;
复制代码

参考文章：juejin.im/post/5cb5d9…

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程