1.3.7 • Published 2 months ago
se-axios v1.3.7
se-axios
se-axios是一个基于axios进行二次封装的工具,开发者只需要使用提供的默认请求实例或者自定义请求实例即可发起请求,无需对请求参数以及响应数据进行拦截处理,se-axios已经帮开发者完成这部分工作 暂不支持非JavaScript项目使用
版本更新
2023.9.14更新
- 新增当请求验证不通过时取消当前请求
2023.8.8更新
- 新增文件上传接口(normalUpload),文件分片上传接口(sliceUpload), 通用文件上传接口(upload),自动判断文件大小选择普通文件上传或者切片文件上传
- 默认当文件大小超过10MB时使用切片文件上传,可使用setConfig函数修改值,参数fileSize(单位MB)
- 默认将文件切片成每份2MB,可使用setConfig函数修改分片大小,参数:sliceSize(单位MB)
- 切片文件上传向后端传递4个参数:file(文件), chunk(当前切片索引), chunks(总切片数), name(文件名)
- 普通文件上传向后端传递1个参数:file(文件)
使用方法
注意:使用方法需要传递3个参数:请求实例(request),请求配置(url,method....),文件对象(data)
import { Request, upload, normalUpload, sliceUpload } from 'se-axios'
//通过setConfig函数修改切片大小
setConfig({
sliceSize: 2, //切片大小 单位MB
fileSize: 10, //文件大小 单位MB
})
const request = new Request({
requestConfig:{
baseURL: 'http://localhost:8085/api/',
timeout: 2000,
},
})
//传递的data必须为File对象
//通用文件上传
export function up(data){
return upload(request, {
url:'/chat/upload',
method: 'post'
},
data)
}
//切片文件上传
export function up(data){
return sliceUpload(request, {
url:'/chat/upload',
method: 'post'
},
data)
}
//普通文件上传
export function up(data){
return normalUpload(request, {
url:'/chat/upload',
method: 'post'
},
data)
}
2023.7.30更新
新增请求白名单,在启用token时,可以通过配置请求白名单,定义不需要验证token的请求,,如若不配置则默认‘login’,’/login’请求不验证token
配置使用数组方式
配置的url规则aa/bb形式前后不要添加 ’/‘ ,且要与请求实例中的url保持一致
示例: 当url = '/aaa/bbb/' 或 'ccc/ddd/'时 配置白名单中的url需改成:excludePath:['aaa/bbb', 'ccc/ddd']
使用方法
setConfig({
Authentication: true, //启用身份验证时
excludePath:['api/login', 'api/testput']
})
安装
npm install se-axios
特性
开发者只需要关注自己的项目请求方法
export function functionName(data){
return request({
url: '***/***',
method: 'post',
data: data
})
}
提供了默认的请求拦截器,响应拦截器,满足大部分开发需求,开发者无需自己编写
开发者不满足默认的请求拦截器和响应拦截器时,可通过配置requestInterceptors和responseInterceptors来自定义自己的拦截器
{
requestInterceptors: (config) =>{
//....... 自己的请求拦截器逻辑
//最后一定要return config
return config
},
responseInterceptors:(res) =>{
//....... 自己的响应拦截器逻辑
return res.data
}
}
提供了默认的请求实例,用户可以通过导入service直接使用,默认请求实例的baseURL:http://localhost:8080/
import { service } from "se-axios"
export function functionName(data){
return service({
url: '***/***/***',
method: 'post',
data: data,
})
}
提供了自定义创建请求实例的接口,通过导入Request来创建自定义实例
import { Request } from "se-axios"
//使用自定义请求实例
const request = new Request({
requestConfig:{
baseURL: 'http://localhost:8080/***/',
timeout: 2000,
},
})
提供了函数来对响应数据进行处理,提示请求结果
开发者可以根据自己的需求自定义响应数据处理方式
const request = new Request({
requestConfig:{
baseURL: 'http://localhost:8080/***/',
timeout: 2000,
//在请求实例设置该函数对所有的请求都使用, 且方法名必须是success,warning,exception, //acquiesce
success: (e) =>{
console.log(e)
},
warning: (e) =>{
console.log(e)
},
exception: (e) =>{
console.log(e)
},
acquiesce: (e) =>{
console.log(e)
}
},
})
//在具体的每个业务函数中定义时只对该函数有效
export function joinChat(data){
return my({
url: 'chat/login',
method: 'post',
data: data,
success: (e) =>{
Message({ message: e, type: 'success' })
},
exception: (e) =>{
console.log('exception', e)
}
})
}
提供了setConfig和restoreConfig方法修改默认配置
import { setConfig, restoreConfig } from "se-axios"
//修改默认配置
setConfig({
Authentication: false
})
//还原默认配置
restoreConfig()
默认配置列表,可以根据实际需求通过setConfig添加自己的配置,通过导入requestConfig进行访问
{
tokenName: 'Authorization', //前端存在本地的tokenname
responseTokenName: 'authorization', //后端返回的tokenname 后端返回的tokenname不管首字母是否大小, 这里都必须设置为首字母小写,否则获取不到
index: '/login', //为认证或过期时重定向的页面
Authentication: true, //是否进行身份验证 默认开启
excludePath: ['/login', 'login'],
sliceSize: 2, //切片大小 单位MB
fileSize: 10, //使用切片上传的文件大小
noAuthentication: (e) =>{ //身份校验不通过时执行的方法
MessageBox.confirm(e,
'系统提示', {
confirmButtonText: '确定',
cancelButtonText: '取消',
type: 'warning' }).then(() => {
location.href = this.requestConfig.index;
}).catch(() => {
});
},
headers:{
'Content-Type': 'application/json;charset=utf-8'
},
success: (e) =>{
Message({message: e, type: 'success'})
},
warning: (e)=>{
Message({message: e, type: 'warning'})
},
exception: (e) =>{
Message({message: e, type: 'error'})
},
acquiesce: (e) =>{
Message({message: e, type: 'info'})
},
}
提供了错误码表,开发者可以根据实际进行修改添加
'warning': {
401: {
text: '401警告', //警告文本
type: null, //警告类型,如果使用的是element-ui,则可以使用info,primary,warning,danger等
default: 'warning' //默认警告类型
},
403: {
text: '403警告',
type: null,
default: 'warning'
},
404: {
text: '404警告',
type: null,
default: 'warning'
},
},
'exception': {
500: {
text: '500异常',
type: null,
default: 'error'
},
501: {
text: '501异常',
type: null,
default: 'error'
},
},
acquiesce: {
text: '系统未知错误,请反馈给开发者',
default: 'info'
}
使用方法
在全局或局部导入se-axios
在需要请求的地方使用service或者自定义请求实例发送请求
import { Request, service} from "se-axios" //创建自定义请求实例 const request = new Request({ requestConfig:{ baseURL: 'http://localhost:8085/api/', timeout: 2000, }, }) export function joinChat(data){ //在自己的函数中使用实例 return request({ url: 'chat/testpost', method: 'post', data: data }) } //使用默认请求实例 export function joinChat(data){ return service({ url: 'api/chat/login', method: 'post', data: data, exception:(e) =>{ console.log('异常',e); } }) }