vue-axios-optimize 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +484 -461
  2. package/index.js +1 -1
  3. package/package.json +17 -17
package/README.md CHANGED
@@ -1,462 +1,485 @@
1
- # vue-axios-optimize使用说明
2
-
3
- vue-axios-optimize是一个对axios请求优化的vue插件包，引入此包之后，并进行相关配置，即可轻松实现全局请求加载动画，重复请求时取消前面的请求或者阻止后面的请求。
4
-
5
- ## 安装
6
-
7
- ```shell
8
- npm install vue-axios-optimize
9
- ```
10
-
11
- ## 引入
12
-
13
- 在src/api目录下新建axios-optimize.js文件
14
-
15
- api目录大致如下
16
-
17
- > src
18
- >
19
- > > api
20
- > >
21
- > > > modules
22
- > > >
23
- > > > > common-api.js
24
- > > >
25
- > > > index.js
26
- > > >
27
- > > > axios.js
28
- > > >
29
- > > > axios-optimize.js
30
-
31
- axios-optimize.js文件内容大致如下
32
-
33
- ```js
34
- import axios from 'axios'
35
- import instance from '@/api/axios.js'
36
-
37
- import axiosOptimize from 'vue-axios-optimize'
38
- import { useAppStoreHook } from '@/store/modules/app'
39
- const useAppStore = useAppStoreHook()
40
-
41
- import { useUserStoreHook } from '@/store/modules/user'
42
-
43
- import { ElMessageBox } from 'element-plus'
44
-
45
- const AxiosOptimize = new axiosOptimize(axios, instance, {
46
- showLoadingFun: () => {
47
- // 展示加载动画方法
48
- useAppStore.setLoadingStatus(true)
49
- },
50
- hideLoadingFun: () => {
51
- // 关闭加载动画方法
52
- useAppStore.setLoadingStatus(false)
53
- },
54
- openRefresh: true, // 开启无感知刷新token 默认不开 开启时 下面的参数才有效
55
- refreshApiUrl: '/xiaobu-admin/refresh-token', // 刷新tokenApi的 url
56
- getRefreshTokenFun: () => {
57
- const useUserStore = useUserStoreHook()
58
- // 获取refreshToken
59
- return useUserStore.gettersRefreshToken
60
- },
61
- reloginFun: async (response) => {
62
- // 重新登录方法 建议如下形式清除 缓存中token等信息后 弹框提示 点击确认后 刷新页面
63
- const useUserStore = useUserStoreHook()
64
- // 清除缓存中的token等信息
65
- await useUserStore.clearAuth()
66
- ElMessageBox.alert(`${response.message}`, '提示', {
67
- confirmButtonText: 'OK',
68
- showClose: false,
69
- callback: async (action) => {
70
- if (action === 'confirm') {
71
- // 刷新浏览器是为了 跳转登录页时query的redirect 会带上 当前页面地址（路由拦截处的逻辑）
72
- window.location.reload()
73
- }
74
- }
75
- })
76
- },
77
- refreshTokenStore: (refreshToken) => {
78
- // 使用refreshToken 调用刷新token接口 获取新的accessToken 并存储到对应缓存中 使接口能用
79
- const useUserStore = useUserStoreHook()
80
- // 调用store的获取refreshToken方法 同时会将新的accessToken存储到缓存
81
- return useUserStore.refreshTokenAction({ refreshToken })
82
- },
83
- setAccessTokenFun: (config, accessToken) => {
84
- // 根据需求给请求头设置 accessToken 如下两种形式可设置请求头 二选一
85
- // Reflect.set(config.headers, 'authorization', 'Bearer ' + accessToken)
86
- config.headers.authorization = 'Bearer ' + accessToken
87
- },
88
- responseResultFun: (res) => {
89
- /*res数据结构大致如下: 为接口返回的最外层数据 加个 请求时的config
90
- {
91
- code: 200,
92
- data: XXX,
93
- message: XXX,
94
- config: {}
95
- }
96
- */
97
- // 此方法配置 返回数据 的 逻辑
98
- if (res.config.responesType === 'blob') {
99
- delete res.config
100
- return res
101
- }
102
- if (res.code === 200) {
103
- return res.data
104
- }
105
- delete res.config
106
- return res
107
- },
108
- formatAccessToken: (data) => {
109
- // 此方法返回 请求接口后 返回的 accessToken
110
- return data.accessToken
111
- }
112
- })
113
-
114
- export default AxiosOptimize.instance
115
-
116
- ```
117
-
118
- axios.js的内容需要做些细微的更改 大致内容如下
119
-
120
- ```js
121
- import axios from 'axios'
122
- import { ElMessage } from 'element-plus'
123
- import { useUserStoreHook } from '@/store/modules/user'
124
-
125
- // 创建axios实例
126
- const service = axios.create({
127
- baseURL: '/proxy',
128
- timeout: 10000
129
- })
130
-
131
- // request拦截器
132
- service.interceptors.request.use(
133
- (config) => {
134
- // 一般会请求拦截里面加token
135
- const useUserStore = useUserStoreHook()
136
- const accessToken = useUserStore.gettersAccessToken
137
- if (accessToken) {
138
- config.headers['authorization'] = 'Bearer ' + accessToken
139
- }
140
-
141
- return config
142
- },
143
- (error) => {
144
- // 这个return 一定记得 带上 否则无法使用
145
- return Promise.reject(error)
146
- }
147
- )
148
-
149
- // respone拦截器
150
- service.interceptors.response.use(
151
- async (res) => {
152
- const { config, data } = res
153
-
154
- // code为200 直接返回有用数据 多返回一个config ...data 为接口返回的最外层数据
155
- if (data.code === 200) {
156
- return { ...data, config }
157
- }
158
- // 当项目无 无感知刷新token的功能时 此处对应code该什么逻辑就什么逻辑
159
- // dosomething ... 如 code === 401 时 清除token 刷新页面等
160
-
161
- // 报错时 多返回一个 报错标识 responseErr: true ...data 为接口返回的最外层数据
162
- return { ...data, config, responseErr: true }
163
- },
164
- (error) => {
165
- if (error.name === 'AxiosError') {
166
- ElMessage({
167
- showClose: true,
168
- message: `${error.message}，请检查网络或联系管理员！`,
169
- type: 'error'
170
- })
171
- }
172
- // 注意return 不可丢失
173
- return Promise.reject(error)
174
- }
175
- )
176
-
177
- export default service
178
-
179
- ```
180
-
181
- 接口处使用，如commo-api.js 大致如下
182
-
183
- ```js
184
- import axiosOptimize from '@/api/axios-optimize.js'
185
-
186
- // 需要配置 请求接口时 不加载全局动画 则 配置 noShowLoading: true
187
- // 需要配置 重复请求时 取消前面的请求 则 配置 preventDuplicateRequestsType: "cancel"
188
- // 需要配置 重复请求时 禁用后面的请求 则 配置 preventDuplicateRequestsType: "prevent"
189
-
190
- // get 请求demo 1
191
- export function getDemo1(
192
- data = {},
193
- config = {
194
- noShowLoading: true, // 配置不展示加载动画
195
- preventDuplicateRequestsType: "cancel" // 配置重复请求时 取消前面的请求
196
- }
197
- ) {
198
- return axiosOptimize.get(`/xiaobu-admin/getDemo1`, { params: data, ...config })
199
- }
200
-
201
- // get 请求 demo 2
202
- export function getDemo2(
203
- data = {},
204
- config = {
205
- preventDuplicateRequestsType: "prevent" // 配置重复请求时 后面的请求无效
206
- }
207
- ) {
208
- return axiosOptimize({
209
- method: 'get',
210
- url: `/xiaobu-admin/getDemo2`,
211
- params: data,
212
- ...config
213
- })
214
- }
215
-
216
- // post 请求demo 1
217
- export function postDemo1(data = {}, config = {}) {
218
- return axiosOptimize.post('/xiaobu-admin/postDemo1', data, config)
219
- }
220
-
221
- // post 请求demo 2
222
- export function postDemo2(data = {}, config: UserAxiosRequestConfig = {}) {
223
- return axiosOptimize({
224
- url: '/xiaobu-admin/postDemo2',
225
- method: 'post',
226
- data,
227
- ...config
228
- })
229
- }
230
-
231
- // delete 请求demo 1 使用params作为参数 参数会拼接在请求路径上
232
- export function deleteDemo1(
233
- data = {},
234
- config = {
235
- noShowLoading: true // 配置不展示加载动画
236
- }
237
- ) {
238
- return axiosOptimize.delete(`/xiaobu-admin/deleteDemo1`, { params: data, ...config })
239
- }
240
-
241
- // delete 请求 demo 2 使用params作为参数 参数会拼接在请求路径上
242
- export function deleteDemo2(
243
- data = {},
244
- config = {}
245
- ) {
246
- return axiosOptimize({
247
- method: 'delete',
248
- url: `/xiaobu-admin/deleteDemo2`,
249
- params: data,
250
- ...config
251
- })
252
- }
253
-
254
- // delete 请求demo 3 使用data作为参数 参数不展示在 请求路径上
255
- export function deleteDemo3(data = {}, config = {}) {
256
- return axiosOptimize.delete(`/xiaobu-admin/deleteDemo3`, { data, ...config })
257
- }
258
-
259
- // delete 请求 demo 4 使用data作为参数 参数不展示在 请求路径上
260
- export function deleteDemo4(data = {}, config = {}) {
261
- return axiosOptimize({
262
- method: 'delete',
263
- url: `/xiaobu-admin/deleteDemo4`,
264
- data,
265
- ...config
266
- })
267
- }
268
-
269
- // put 请求demo 1
270
- export function putDemo1(data = {}, config = {}) {
271
- return axiosOptimize.put('/xiaobu-admin/putDemo1', data, config)
272
- }
273
-
274
- // put 请求demo 2
275
- export function putDemo2(data = {}, config = {}) {
276
- return axiosOptimize({
277
- url: '/xiaobu-admin/putDemo2',
278
- method: 'put',
279
- data,
280
- ...config
281
- })
282
- }
283
-
284
- // patch 请求demo 1
285
- export function patchDemo1(data = {}, config = {}) {
286
- return axiosOptimize.patch('/xiaobu-admin/patchDemo1', data, config)
287
- }
288
-
289
- // patch 请求demo 2
290
- export function patchDemo2(data = {}, config = {}) {
291
- return axiosOptimize({
292
- url: '/xiaobu-admin/patchDemo2',
293
- method: 'patch',
294
- data,
295
- ...config
296
- })
297
- }
298
-
299
- ```
300
-
301
- ## new axiosOptimize(axios, instance, options）参数说明
302
-
303
- | 参数 | 说明 | 来源 |
304
- | -------- | --------------------------------------------- | ------------------------------------- |
305
- | axios | 安装axios中的axios | import axios from 'axios' |
306
- | instance | 创建好的axios实例，已经配置好请求头等相关内容 | import instance from '@/api/axios.js' |
307
- | options | 一些配置，详情继续阅读文档 | 自定义配置 |
308
-
309
- ## options配置
310
-
311
- | 参数 | 类型 | 说明 | 是否必传 | 默认值 |
312
- | -------------------------------------- | -------- | ------------------------------------------------------------ | ------------------------- | ----------------------------------- |
313
- | showLoadingFun(config, requestingNum) | Function | 展示动画,config为该请求的config，requestingNum为目前正在请求几个接口，此处可执行一些展示全局动画的操作 | 否 | 无 |
314
- | hideLoadingFun(config, requestingNum) | Function | 隐藏动画,config为该请求的config，requestingNum为目前正在请求几个接口，此时应该为0，此处可执行关闭全局动画的操作 | 否 | 无 |
315
- | openRefresh | Boolean | 是否开启无感知刷新token | 否 | false |
316
- | refreshApiUrl | String | 请求刷新token接口的api地址 如/xiaobu-admin/refresh-token | 当openRefresh为true时必传 | 无 |
317
- | getRefreshTokenFun() | Function | 获取当前项目的 refreshToken方法， 记得 return 回去 | 当openRefresh为true时必传 | 无 |
318
- | reloginFun(response) | Function | response 为axios实例中返回的数据，此处建议执行清除token相关缓存并弹框提示，点击确认进行刷新页面操作 | 当openRefresh为true时必传 | 无 |
319
- | refreshTokenStore(refreshToken) | Function | refreshToken为当前浏览器缓存的refreshToken，需要返回一个Promise，利用此refreshToken调用接口获取新的accessToken 并设置。 | 当openRefresh为true时必传 | 无 |
320
- | setAccessTokenFun(config, accessToken) | Function | config为该请求的config，accessToken 为新获取的accessToken, 此处需要将accessToken设置到请求头中 | 当openRefresh为true时必传 | 无 |
321
- | responseResultFun(res) | Function | res为axios实例返回的res，格式化接口请求成功后返回的数据 | 非必传 | axios实例返回的res |
322
- | formatAccessTokenFun(data) | Function | data为responseResultFun报错时返回的res | 非必传 | axios实例返回的res.data.accessToken |
323
- | accessTokenExpirationCode | number | 配置accessToken过期返回的业务状态码 | 非必传 | 401 |
324
- | refreshTokenExpirationCode | number | 配置refreshToken过期返回的业务状态码 | 非必传 | 403 |
325
-
326
- ## store/user.ts代码大致如下
327
-
328
- ```ts
329
- import { defineStore } from 'pinia'
330
- import { store } from '@/store'
331
- import { commonApi } from '@/api'
332
- import storage, { userKey } from '@/utils/storage'
333
- import { setCookie, getCookie, removeCookie, accessTokenKey, refreshTokenKey } from '@/utils/cookie'
334
- import { LoginVO, UserInfoVO, RefreshTokenVO } from '@/api/vo/common-vo'
335
- import { RefreshTokenDTO } from '@/api/dto/common-dto'
336
- const storageData = storage.info()
337
-
338
- const useUserStore = defineStore('user', {
339
- state: () => {
340
- return {
341
- accessToken: getCookie(accessTokenKey) || '',
342
- refreshToken: getCookie(refreshTokenKey) || '',
343
- userInfo: storageData[userKey] || null
344
- }
345
- },
346
-
347
- getters: {
348
- gettersRefreshToken: (state) => {
349
- return state.refreshToken
350
- },
351
- gettersAccessToken: (state) => {
352
- return state.accessToken
353
- },
354
- gettersUserInfo: (state) => {
355
- return () => state.userInfo
356
- }
357
- },
358
-
359
- actions: {
360
- // 设置cookie
361
- setToken(data: LoginVO) {
362
- this.accessToken = data.accessToken
363
- setCookie(accessTokenKey, data.accessToken, data.expiresIn)
364
- this.refreshToken = data.refreshToken
365
- setCookie(refreshTokenKey, data.refreshToken, data.expiresIn)
366
- },
367
- // 清除AccessToken及RefreshToken
368
- clearAuth() {
369
- this.accessToken = ''
370
- removeCookie(accessTokenKey)
371
- this.refreshToken = ''
372
- removeCookie(refreshTokenKey)
373
- this.userInfo = null
374
- storage.remove(userKey)
375
- },
376
- // 刷新token
377
- async refreshTokenAction(params: RefreshTokenDTO) {
378
- return new Promise<RefreshTokenVO>((resolve, reject) => {
379
- commonApi
380
- .refreshToken(params)
381
- .then((data) => {
382
- this.setToken(data)
383
- resolve(data)
384
- })
385
- .catch((err) => {
386
- reject(err)
387
- })
388
- })
389
- },
390
-
391
- // 获取用户信息
392
- async getUserInfo() {
393
- return new Promise<UserInfoVO>((resolve, reject) => {
394
- commonApi
395
- .getUserInfo()
396
- .then((data) => {
397
- this.userInfo = data
398
- storage.set(userKey, data)
399
- resolve(data)
400
- })
401
- .catch((err) => {
402
- reject(err)
403
- })
404
- })
405
- }
406
- }
407
- })
408
-
409
- export function useUserStoreHook() {
410
- return useUserStore(store)
411
- }
412
-
413
- ```
414
-
415
- ## 注意
416
-
417
- 如果要配置无感知刷新token时，对后端是有要求的，需要做到当accessToken过期refreshToken未过期时，请求接口的业务状态码 code为 配置的 accessTokenExpirationCode 的值， 默认401，当refreshToken过期或其他问题报错导致系统无法运行的错误时 业务状态码code 应为配置的 refreshTokenExpirationCode， 默认403
418
-
419
- 当部分页面接口请求在catch处有操作时 需添加语句， 参考如下示例
420
-
421
- ```js
422
- this.loading = true
423
- testApi.getUserList(this.addDateRange(this.queryParams, this.dateRange)).then(res => {
424
- const response = res.data
425
- this.list = response.rows
426
- this.total = response.total
427
- this.loading = false
428
- }).catch(err => {
429
- // 此处需要添加 如果是取消请求 或者是 阻止请求时 不进行操作
430
- if (err.isPervent || err?.message?.isCancel) {
431
- return
432
- }
433
- this.loading = false
434
- })
435
- ```
436
-
437
-
438
-
439
- ## 总结
440
-
441
- 如有疑问，可关注微信公众号【爆米花小布】进行咨询。
442
-
443
- ![微信公众号](https://shenxiaobu.github.io/global-static/img/gongzhonghao_wechat.png)
444
-
445
- 微信公众号【爆米花小布】，抖音号【爆米花小布】 更多好玩的插件
446
-
447
- [vue2-element-dict字典包插件](https://www.npmjs.com/package/vue2-element-dict)
448
-
449
- [vue3-element-dict字典包插件](https://www.npmjs.com/package/vue3-element-dict)
450
-
451
- [vue2-vant-dict移动端字典包插件](https://www.npmjs.com/package/vue2-vant-dict)
452
-
453
- [vue3-water-marker水印插件](https://www.npmjs.com/package/vue3-water-marker)
454
-
455
- [vue2-water-marker水印插件](https://www.npmjs.com/package/vue2-water-marker)
456
-
457
-
458
- ## 更新日志
459
-
460
- ### 1.0.0
461
-
1
+ # vue-axios-optimize使用说明
2
+
3
+ vue-axios-optimize是一个对axios请求优化的vue插件包，引入此包之后，并进行相关配置，即可轻松实现全局请求加载动画，重复请求时取消前面的请求或者阻止后面的请求。
4
+
5
+ ## 安装
6
+
7
+ ```shell
8
+ npm install vue-axios-optimize
9
+ ```
10
+
11
+ ## 引入
12
+
13
+ 在src/api目录下新建axios-optimize.js文件
14
+
15
+ api目录大致如下
16
+
17
+ > src
18
+ >
19
+ > > api
20
+ > >
21
+ > > > modules
22
+ > > >
23
+ > > > > common-api.js
24
+ > > >
25
+ > > > index.js
26
+ > > >
27
+ > > > axios.js
28
+ > > >
29
+ > > > axios-optimize.js
30
+
31
+ axios-optimize.js文件内容大致如下
32
+
33
+ ```js
34
+ import axios from 'axios'
35
+ import instance from '@/api/axios.js'
36
+
37
+ import axiosOptimize from 'vue-axios-optimize'
38
+ import { useAppStoreHook } from '@/store/modules/app'
39
+ const useAppStore = useAppStoreHook()
40
+
41
+ import { useUserStoreHook } from '@/store/modules/user'
42
+
43
+ import { ElMessageBox } from 'element-plus'
44
+
45
+ const AxiosOptimize = new axiosOptimize(axios, instance, {
46
+ responseTypesStr: "arraybuffer,blob",
47
+ showLoadingFun: () => {
48
+ // 展示加载动画方法
49
+ useAppStore.setLoadingStatus(true)
50
+ },
51
+ hideLoadingFun: () => {
52
+ // 关闭加载动画方法
53
+ useAppStore.setLoadingStatus(false)
54
+ },
55
+ openRefresh: true, // 开启无感知刷新token 默认不开 开启时 下面的参数才有效
56
+ refreshApiUrl: '/xiaobu-admin/refresh-token', // 刷新tokenApi的 url
57
+ getRefreshTokenFun: () => {
58
+ const useUserStore = useUserStoreHook()
59
+ // 获取refreshToken
60
+ return useUserStore.gettersRefreshToken
61
+ },
62
+ reloginFun: async (response) => {
63
+ // 重新登录方法 建议如下形式清除 缓存中token等信息后 弹框提示 点击确认后 刷新页面
64
+ const useUserStore = useUserStoreHook()
65
+ // 清除缓存中的token等信息
66
+ await useUserStore.clearAuth()
67
+ ElMessageBox.alert(`${response.message}`, '提示', {
68
+ confirmButtonText: 'OK',
69
+ showClose: false,
70
+ callback: async (action) => {
71
+ if (action === 'confirm') {
72
+ // 刷新浏览器是为了 跳转登录页时query的redirect 会带上 当前页面地址（路由拦截处的逻辑）
73
+ window.location.reload()
74
+ }
75
+ }
76
+ })
77
+ },
78
+ refreshTokenStore: (refreshToken) => {
79
+ // 使用refreshToken 调用刷新token接口 获取新的accessToken 并存储到对应缓存中 使接口能用
80
+ const useUserStore = useUserStoreHook()
81
+ // 调用store的获取refreshToken方法 同时会将新的accessToken存储到缓存
82
+ return useUserStore.refreshTokenAction({ refreshToken })
83
+ },
84
+ setAccessTokenFun: (config, accessToken) => {
85
+ // 根据需求给请求头设置 accessToken 如下两种形式可设置请求头 二选一
86
+ // Reflect.set(config.headers, 'authorization', 'Bearer ' + accessToken)
87
+ config.headers.authorization = 'Bearer ' + accessToken
88
+ },
89
+ responseResultFun: (res) => {
90
+ /*res数据结构大致如下: 为接口返回的最外层数据 加个 请求时的config
91
+ {
92
+ code: 200,
93
+ data: XXX,
94
+ message: XXX,
95
+ config: {}
96
+ }
97
+ */
98
+ // 此方法配置 返回数据 的 逻辑
99
+ if (res.config.responesType === 'blob') {
100
+ delete res.config
101
+ return res
102
+ }
103
+ if (res.code === 200) {
104
+ return res.data
105
+ }
106
+ delete res.config
107
+ return res
108
+ },
109
+ formatAccessToken: (data) => {
110
+ // 此方法返回 请求接口后 返回的 accessToken
111
+ return data.accessToken
112
+ }
113
+ })
114
+
115
+ export default AxiosOptimize.instance
116
+ ```
117
+
118
+ axios.js的内容需要做些细微的更改 大致内容如下
119
+
120
+ ```js
121
+ import axios from 'axios'
122
+ import { ElMessage } from 'element-plus'
123
+ import { useUserStoreHook } from '@/store/modules/user'
124
+
125
+ // 创建axios实例
126
+ const service = axios.create({
127
+ baseURL: '/proxy',
128
+ timeout: 10000
129
+ })
130
+
131
+ // request拦截器
132
+ service.interceptors.request.use(
133
+ (config) => {
134
+ // 一般会请求拦截里面加token
135
+ const useUserStore = useUserStoreHook()
136
+ const accessToken = useUserStore.gettersAccessToken
137
+ if (accessToken) {
138
+ config.headers['authorization'] = 'Bearer ' + accessToken
139
+ }
140
+
141
+ return config
142
+ },
143
+ (error) => {
144
+ // 这个return 一定记得 带上 否则无法使用
145
+ return Promise.reject(error)
146
+ }
147
+ )
148
+
149
+ // respone拦截器
150
+ service.interceptors.response.use(
151
+ async (res) => {
152
+ // 二进制数据则直接返回
153
+ if (res.request.responseType === "blob" || res.request.responseType === "arraybuffer"){
154
+ return res
155
+ }
156
+ const { config, data } = res
157
+
158
+ // code为200 直接返回有用数据 多返回一个config ...data 为接口返回的最外层数据
159
+ if (data.code === 200) {
160
+ return { ...data, config }
161
+ }
162
+ // 当项目无 无感知刷新token的功能时 此处对应code该什么逻辑就什么逻辑
163
+ // dosomething ... 如 code === 401 时 清除token 刷新页面等
164
+
165
+ // 报错时 多返回一个 报错标识 responseErr: true ...data 为接口返回的最外层数据
166
+ return { ...data, config, responseErr: true }
167
+ },
168
+ (error) => {
169
+ if (error.name === 'AxiosError') {
170
+ ElMessage({
171
+ showClose: true,
172
+ message: `${error.message}，请检查网络或联系管理员！`,
173
+ type: 'error'
174
+ })
175
+ }
176
+ // 注意return 不可丢失
177
+ return Promise.reject(error)
178
+ }
179
+ )
180
+
181
+ export default service
182
+ ```
183
+
184
+ 接口处使用，如commo-api.js 大致如下
185
+
186
+ ```js
187
+ import axiosOptimize from '@/api/axios-optimize.js'
188
+
189
+ // 需要配置 请求接口时 不加载全局动画 则 配置 noShowLoading: true
190
+ // 需要配置 重复请求时 取消前面的请求 则 配置 preventDuplicateRequestsType: "cancel"
191
+ // 需要配置 重复请求时 禁用后面的请求 则 配置 preventDuplicateRequestsType: "prevent"
192
+
193
+ // get 请求demo 1
194
+ export function getDemo1(
195
+ data = {},
196
+ config = {
197
+ noShowLoading: true, // 配置不展示加载动画
198
+ preventDuplicateRequestsType: "cancel" // 配置重复请求时 取消前面的请求
199
+ }
200
+ ) {
201
+ return axiosOptimize.get(`/xiaobu-admin/getDemo1`, { params: data, ...config })
202
+ }
203
+
204
+ // get 请求 demo 2
205
+ export function getDemo2(
206
+ data = {},
207
+ config = {
208
+ preventDuplicateRequestsType: "prevent" // 配置重复请求时 后面的请求无效
209
+ }
210
+ ) {
211
+ return axiosOptimize({
212
+ method: 'get',
213
+ url: `/xiaobu-admin/getDemo2`,
214
+ params: data,
215
+ ...config
216
+ })
217
+ }
218
+
219
+ // post 请求demo 1
220
+ export function postDemo1(data = {}, config = {}) {
221
+ return axiosOptimize.post('/xiaobu-admin/postDemo1', data, config)
222
+ }
223
+
224
+ // post 请求demo 2
225
+ export function postDemo2(data = {}, config: UserAxiosRequestConfig = {}) {
226
+ return axiosOptimize({
227
+ url: '/xiaobu-admin/postDemo2',
228
+ method: 'post',
229
+ data,
230
+ ...config
231
+ })
232
+ }
233
+
234
+ // delete 请求demo 1 使用params作为参数 参数会拼接在请求路径上
235
+ export function deleteDemo1(
236
+ data = {},
237
+ config = {
238
+ noShowLoading: true // 配置不展示加载动画
239
+ }
240
+ ) {
241
+ return axiosOptimize.delete(`/xiaobu-admin/deleteDemo1`, { params: data, ...config })
242
+ }
243
+
244
+ // delete 请求 demo 2 使用params作为参数 参数会拼接在请求路径上
245
+ export function deleteDemo2(
246
+ data = {},
247
+ config = {}
248
+ ) {
249
+ return axiosOptimize({
250
+ method: 'delete',
251
+ url: `/xiaobu-admin/deleteDemo2`,
252
+ params: data,
253
+ ...config
254
+ })
255
+ }
256
+
257
+ // delete 请求demo 3 使用data作为参数 参数不展示在 请求路径上
258
+ export function deleteDemo3(data = {}, config = {}) {
259
+ return axiosOptimize.delete(`/xiaobu-admin/deleteDemo3`, { data, ...config })
260
+ }
261
+
262
+ // delete 请求 demo 4 使用data作为参数 参数不展示在 请求路径上
263
+ export function deleteDemo4(data = {}, config = {}) {
264
+ return axiosOptimize({
265
+ method: 'delete',
266
+ url: `/xiaobu-admin/deleteDemo4`,
267
+ data,
268
+ ...config
269
+ })
270
+ }
271
+
272
+ // put 请求demo 1
273
+ export function putDemo1(data = {}, config = {}) {
274
+ return axiosOptimize.put('/xiaobu-admin/putDemo1', data, config)
275
+ }
276
+
277
+ // put 请求demo 2
278
+ export function putDemo2(data = {}, config = {}) {
279
+ return axiosOptimize({
280
+ url: '/xiaobu-admin/putDemo2',
281
+ method: 'put',
282
+ data,
283
+ ...config
284
+ })
285
+ }
286
+
287
+ // patch 请求demo 1
288
+ export function patchDemo1(data = {}, config = {}) {
289
+ return axiosOptimize.patch('/xiaobu-admin/patchDemo1', data, config)
290
+ }
291
+
292
+ // patch 请求demo 2
293
+ export function patchDemo2(data = {}, config = {}) {
294
+ return axiosOptimize({
295
+ url: '/xiaobu-admin/patchDemo2',
296
+ method: 'patch',
297
+ data,
298
+ ...config
299
+ })
300
+ }
301
+
302
+ ```
303
+
304
+ ## new axiosOptimize(axios, instance, options）参数说明
305
+
306
+ | 参数 | 说明 | 来源 |
307
+ | -------- | ------------------------- | ------------------------------------- |
308
+ | axios | 安装axios中的axios | import axios from 'axios' |
309
+ | instance | 创建好的axios实例，已经配置好请求头等相关内容 | import instance from '@/api/axios.js' |
310
+ | options | 一些配置，详情继续阅读文档 | 自定义配置 |
311
+
312
+ ## options配置
313
+
314
+ | 参数 | 类型 | 说明 | 是否必传 | 默认值 |
315
+ | -------------------------------------- | -------- | ---------------------------------------- | -------------------- | ------------------------------ |
316
+ | showLoadingFun(config, requestingNum) | Function | 展示动画,config为该请求的config，requestingNum为目前正在请求几个接口，此处可执行一些展示全局动画的操作 | 否 | 无 |
317
+ | hideLoadingFun(config, requestingNum) | Function | 隐藏动画,config为该请求的config，requestingNum为目前正在请求几个接口，此时应该为0，此处可执行关闭全局动画的操作 | 否 | 无 |
318
+ | openRefresh | Boolean | 是否开启无感知刷新token | 否 | false |
319
+ | refreshApiUrl | String | 请求刷新token接口的api地址 如/xiaobu-admin/refresh-token | 当openRefresh为true时必传 | 无 |
320
+ | getRefreshTokenFun() | Function | 获取当前项目的 refreshToken方法， 记得 return 回去 | 当openRefresh为true时必传 | 无 |
321
+ | reloginFun(response) | Function | response 为axios实例中返回的数据，此处建议执行清除token相关缓存并弹框提示，点击确认进行刷新页面操作 | 当openRefresh为true时必传 | 无 |
322
+ | refreshTokenStore(refreshToken) | Function | refreshToken为当前浏览器缓存的refreshToken，需要返回一个Promise，利用此refreshToken调用接口获取新的accessToken 并设置。 | 当openRefresh为true时必传 | 无 |
323
+ | setAccessTokenFun(config, accessToken) | Function | config为该请求的config，accessToken 为新获取的accessToken, 此处需要将accessToken设置到请求头中 | 当openRefresh为true时必传 | 无 |
324
+ | responseResultFun(res) | Function | res为axios实例返回的res，格式化接口请求成功后返回的数据 | 非必传 | axios实例返回的res |
325
+ | formatAccessTokenFun(data) | Function | data为responseResultFun报错时返回的res | 非必传 | axios实例返回的res.data.accessToken |
326
+ | accessTokenExpirationCode | number | 配置accessToken过期返回的业务状态码 | 非必传 | 401 |
327
+ | refreshTokenExpirationCode | number | 配置refreshToken过期返回的业务状态码 | 非必传 | 403 |
328
+ | responseTypesStr（v1.0.2） | String | 配置数据返回类型，实现当此类型时返回原封不动的响应数据的data数据 | 非必传 | 无 |
329
+
330
+ ## store/user.ts代码大致如下
331
+
332
+ ```ts
333
+ import { defineStore } from 'pinia'
334
+ import { store } from '@/store'
335
+ import { commonApi } from '@/api'
336
+ import storage, { userKey } from '@/utils/storage'
337
+ import { setCookie, getCookie, removeCookie, accessTokenKey, refreshTokenKey } from '@/utils/cookie'
338
+ import { LoginVO, UserInfoVO, RefreshTokenVO } from '@/api/vo/common-vo'
339
+ import { RefreshTokenDTO } from '@/api/dto/common-dto'
340
+ const storageData = storage.info()
341
+
342
+ const useUserStore = defineStore('user', {
343
+ state: () => {
344
+ return {
345
+ accessToken: getCookie(accessTokenKey) || '',
346
+ refreshToken: getCookie(refreshTokenKey) || '',
347
+ userInfo: storageData[userKey] || null
348
+ }
349
+ },
350
+
351
+ getters: {
352
+ gettersRefreshToken: (state) => {
353
+ return state.refreshToken
354
+ },
355
+ gettersAccessToken: (state) => {
356
+ return state.accessToken
357
+ },
358
+ gettersUserInfo: (state) => {
359
+ return () => state.userInfo
360
+ }
361
+ },
362
+
363
+ actions: {
364
+ // 设置cookie
365
+ setToken(data: LoginVO) {
366
+ this.accessToken = data.accessToken
367
+ setCookie(accessTokenKey, data.accessToken, data.expiresIn)
368
+ this.refreshToken = data.refreshToken
369
+ setCookie(refreshTokenKey, data.refreshToken, data.expiresIn)
370
+ },
371
+ // 清除AccessToken及RefreshToken
372
+ clearAuth() {
373
+ this.accessToken = ''
374
+ removeCookie(accessTokenKey)
375
+ this.refreshToken = ''
376
+ removeCookie(refreshTokenKey)
377
+ this.userInfo = null
378
+ storage.remove(userKey)
379
+ },
380
+ // 刷新token
381
+ async refreshTokenAction(params: RefreshTokenDTO) {
382
+ return new Promise<RefreshTokenVO>((resolve, reject) => {
383
+ commonApi
384
+ .refreshToken(params)
385
+ .then((data) => {
386
+ this.setToken(data)
387
+ resolve(data)
388
+ })
389
+ .catch((err) => {
390
+ reject(err)
391
+ })
392
+ })
393
+ },
394
+
395
+ // 获取用户信息
396
+ async getUserInfo() {
397
+ return new Promise<UserInfoVO>((resolve, reject) => {
398
+ commonApi
399
+ .getUserInfo()
400
+ .then((data) => {
401
+ this.userInfo = data
402
+ storage.set(userKey, data)
403
+ resolve(data)
404
+ })
405
+ .catch((err) => {
406
+ reject(err)
407
+ })
408
+ })
409
+ }
410
+ }
411
+ })
412
+
413
+ export function useUserStoreHook() {
414
+ return useUserStore(store)
415
+ }
416
+
417
+ ```
418
+
419
+ ## 注意
420
+
421
+ 如果要配置无感知刷新token时，对后端是有要求的，需要做到当accessToken过期refreshToken未过期时，请求接口的业务状态码 code为 配置的 accessTokenExpirationCode 的值， 默认401，当refreshToken过期或其他问题报错导致系统无法运行的错误时 业务状态码code 应为配置的 refreshTokenExpirationCode， 默认403
422
+
423
+ 当部分页面接口请求在catch处有操作时 需添加语句， 参考如下示例
424
+
425
+ ```js
426
+ this.loading = true
427
+ testApi.getUserList(this.addDateRange(this.queryParams, this.dateRange)).then(res => {
428
+ const response = res.data
429
+ this.list = response.rows
430
+ this.total = response.total
431
+ this.loading = false
432
+ }).catch(err => {
433
+ // 此处需要添加 如果是取消请求 或者是 阻止请求时 不进行操作
434
+ if (err.isPrevent || err?.message?.isCancel) {
435
+ return
436
+ }
437
+ this.loading = false
438
+ })
439
+ ```
440
+
441
+ ## 特别注意
442
+
443
+ vue2项目的vue.config.js 需要添加如下配置，对插件包进行编译。
444
+
445
+ ```js
446
+ module.exports = {
447
+ ...
448
+ transpileDependencies: [
449
+ "vue-axios-optimize"
450
+ ],
451
+ ...
452
+ }
453
+ ```
454
+
455
+ ## 总结
456
+
457
+ 如有疑问，可关注微信公众号【爆米花小布】进行咨询。
458
+
459
+ ![微信公众号](https://shenxiaobu.github.io/global-static/img/gongzhonghao_wechat.png)
460
+
461
+ 微信公众号【爆米花小布】，抖音号【爆米花小布】 更多好玩的插件
462
+
463
+ [vue2-element-dict字典包插件](https://www.npmjs.com/package/vue2-element-dict)
464
+
465
+ [vue3-element-dict字典包插件](https://www.npmjs.com/package/vue3-element-dict)
466
+
467
+ [vue2-vant-dict移动端字典包插件](https://www.npmjs.com/package/vue2-vant-dict)
468
+
469
+ [vue3-water-marker水印插件](https://www.npmjs.com/package/vue3-water-marker)
470
+
471
+ [vue2-water-marker水印插件](https://www.npmjs.com/package/vue2-water-marker)
472
+
473
+ ## 更新日志
474
+
475
+ ### 1.0.2
476
+
477
+ 1. options新增responseTypesStr配置项，字符串类型，多个时使用英文逗号隔开,此返回类型的数据直接返回原有数据的data数据。在axios.js原封装函数中返回原始的响应返回数据。解决文件类型数据时不可用的问题
478
+
479
+ ### 1.0.1
480
+
481
+ 1. 修复单词错误问题 isPervent 修改为 isPrevent
482
+
483
+ ### 1.0.0
484
+
462
485
  1. 初始版本
package/index.js CHANGED
@@ -1 +1 @@
1
- class e{instance;requestObj={};requestingNum=0;authErrorArr=[];queue=[];isRefresh=!1;isShowReLoginDialog=!1;constructor(e,s,r){this.instance=s,this.instance.interceptors.request.use((s=>{s.noShowLoading||(this.requestingNum++,r.showLoadingFun&&r.showLoadingFun(s,this.requestingNum));const i=s.url;if(r.openRefresh){-1===this.authErrorArr.indexOf(i)&&this.isRefresh&&i!==r.refreshApiUrl&&this.authErrorArr.push(i)}if(i&&s.preventDuplicateRequestsType)if("cancel"===s.preventDuplicateRequestsType){this.requestObj[i]&&this.requestObj[i].cancel({config:s,isCancel:!0});const r=e.CancelToken;this.requestObj[i]=r.source(),s.cancelToken=this.requestObj[i].token}else if("prevent"===s.preventDuplicateRequestsType){if("requesting"===this.requestObj[i])return Promise.reject({config:s,isPervent:!0});this.requestObj[i]="requesting"}return s}),(e=>Promise.reject(e))),this.instance.interceptors.response.use((async e=>{const{config:s,responseErr:i}=e;if(s.noShowLoading||(this.requestingNum--,this.requestingNum<=0&&r.hideLoadingFun&&r.hideLoadingFun(s,this.requestingNum)),s&&this.requestObj[s.url]&&delete this.requestObj[s.url],i){if(r.openRefresh){const i=this.authErrorArr.indexOf(s.url);if(-1!==i)return this.authErrorArr.splice(i,1),new Promise((e=>{this.queue.push((i=>{r.setAccessTokenFun(s,i),e(this.instance.request(s))}))}));const t=r.accessTokenExpirationCode||401;if(Number(e.code)===t){const i=r.getRefreshTokenFun();if(!i){if(this.isShowReLoginDialog)return;return this.isShowReLoginDialog=!0,r.reloginFun(e),Promise.reject(new Error(e.message||"Error"))}if(this.isRefresh)return new Promise((e=>{this.queue.push((i=>{r.setAccessTokenFun(s,i),e(this.instance.request(s))}))}));this.isRefresh=!0;try{const e=await r.refreshTokenStore(i);let t=null;return t=r.formatAccessTokenFun?r.formatAccessTokenFun(e):e.data.accessToken,this.queue.forEach((e=>e(t))),this.instance.request(s)}catch{if(this.isShowReLoginDialog)return;return this.isShowReLoginDialog=!0,r.reloginFun(e),Promise.reject(new Error(e.message||"Error"))}finally{this.queue=[],this.isRefresh=!1}}const n=r.refreshTokenExpirationCode||403;if(Number(e.code)===n){if(this.isShowReLoginDialog)return;return this.isShowReLoginDialog=!0,r.reloginFun(e),Promise.reject(new Error(e.message||"Error"))}}return Promise.reject(new Error(e.message||"Error"))}const t=JSON.parse(JSON.stringify(e));return delete t.responseErr,r.responseResultFun?r.responseResultFun(t):t}),(e=>{const s=e.config||e?.message?.config||{};return s.noShowLoading||(this.requestingNum--,this.requestingNum<=0&&r.hideLoadingFun&&r.hideLoadingFun(s,this.requestingNum)),e.isPervent||e?.message?.isCancel||delete this.requestObj[s.url],Promise.reject(e)}))}}export default e;
1
+ class e{instance;requestObj={};requestingNum=0;authErrorArr=[];queue=[];isRefresh=!1;isShowReLoginDialog=!1;constructor(e,s,r){this.instance=s,this.instance.interceptors.request.use((s=>{s.noShowLoading||(this.requestingNum++,r.showLoadingFun&&r.showLoadingFun(s,this.requestingNum));const t=s.url;if(r.openRefresh){-1===this.authErrorArr.indexOf(t)&&this.isRefresh&&t!==r.refreshApiUrl&&this.authErrorArr.push(t)}if(t&&s.preventDuplicateRequestsType)if("cancel"===s.preventDuplicateRequestsType){this.requestObj[t]&&this.requestObj[t].cancel({config:s,isCancel:!0});const r=e.CancelToken;this.requestObj[t]=r.source(),s.cancelToken=this.requestObj[t].token}else if("prevent"===s.preventDuplicateRequestsType){if("requesting"===this.requestObj[t])return Promise.reject({config:s,isPrevent:!0});this.requestObj[t]="requesting"}return s}),(e=>Promise.reject(e))),this.instance.interceptors.response.use((async e=>{const{config:s,responseErr:t}=e;if(s.noShowLoading||(this.requestingNum--,this.requestingNum<=0&&(this.requestObj={},r.hideLoadingFun&&r.hideLoadingFun(s,this.requestingNum))),s&&this.requestObj[s.url]&&delete this.requestObj[s.url],t){if(r.openRefresh){const t=this.authErrorArr.indexOf(s.url);if(-1!==t)return this.authErrorArr.splice(t,1),new Promise((e=>{this.queue.push((t=>{r.setAccessTokenFun(s,t),e(this.instance.request(s))}))}));const i=r.accessTokenExpirationCode||401;if(Number(e.code)===i){const t=r.getRefreshTokenFun();if(!t){if(this.isShowReLoginDialog)return;return this.isShowReLoginDialog=!0,r.reloginFun(e),Promise.reject(new Error(e.message||"Error"))}if(this.isRefresh)return new Promise((e=>{this.queue.push((t=>{r.setAccessTokenFun(s,t),e(this.instance.request(s))}))}));this.isRefresh=!0;try{const e=await r.refreshTokenStore(t);let i=null;return i=r.formatAccessTokenFun?r.formatAccessTokenFun(e):e.data.accessToken,this.queue.forEach((e=>e(i))),this.instance.request(s)}catch{if(this.isShowReLoginDialog)return;return this.isShowReLoginDialog=!0,r.reloginFun(e),Promise.reject(new Error(e.message||"Error"))}finally{this.queue=[],this.isRefresh=!1}}const n=r.refreshTokenExpirationCode||403;if(Number(e.code)===n){if(this.isShowReLoginDialog)return;return this.isShowReLoginDialog=!0,r.reloginFun(e),Promise.reject(new Error(e.message||"Error"))}}return Promise.reject(new Error(e.message||"Error"))}if(r.responseTypesStr?.toLocaleLowerCase().split(",").includes(s.responseType?.toLocaleLowerCase()))return e.data;const i=JSON.parse(JSON.stringify(e));return delete i.responseErr,r.responseResultFun?r.responseResultFun(i):i}),(e=>{const s=e.config||e?.message?.config||{};return s.noShowLoading||(this.requestingNum--,this.requestingNum<=0&&(this.requestObj={},r.hideLoadingFun&&r.hideLoadingFun(s,this.requestingNum))),e.isPrevent||e?.message?.isCancel||delete this.requestObj[s.url],Promise.reject(e)}))}}export default e;
package/package.json CHANGED
@@ -1,17 +1,17 @@
1
- {
2
- "name": "vue-axios-optimize",
3
- "version": "1.0.0",
4
- "description": "vue项目对axios请求的优化，实现可配置展示全局加载动画，可配置是否重复请求时取消前面的请求或者阻止后面的请求。",
5
- "main": "index.js",
6
- "scripts": {
7
-
8
- },
9
- "keywords": [
10
- "vue",
11
- "axios",
12
- "vue3",
13
- "vue2"
14
- ],
15
- "author": "沈延祥",
16
- "license": "ISC"
17
- }
1
+ {
2
+ "name": "vue-axios-optimize",
3
+ "version": "1.0.2",
4
+ "description": "vue项目对axios请求的优化，实现可配置展示全局加载动画，可配置是否重复请求时取消前面的请求或者阻止后面的请求。",
5
+ "main": "index.js",
6
+ "scripts": {
7
+
8
+ },
9
+ "keywords": [
10
+ "vue",
11
+ "axios",
12
+ "vue3",
13
+ "vue2"
14
+ ],
15
+ "author": "沈延祥",
16
+ "license": "ISC"
17
+ }