Knife4j+Axios+Redis前后端分離架構(gòu)下的?API?管理與會(huì)話(huà)方案(最新推薦)
一、Swagger 與 Knife4j 的深度理解及配置要點(diǎn)
Knife4j是Swagger的加強(qiáng)版
對(duì)于Swagger的理解
API文檔自動(dòng)生成,Swagger通過(guò)注解或代碼掃描,生成交互式API文檔。接口測(cè)試與調(diào)試
Knife4j 是為 Swagger 量身定制的增強(qiáng) UI 框架,解決了原生 Swagger UI 的一些痛點(diǎn):
優(yōu)化界面布局,支持分組、搜索、離線(xiàn)文檔等功能
增強(qiáng)文檔可讀性,如參數(shù)說(shuō)明高亮、響應(yīng)示例格式化
提供更多擴(kuò)展功能,如接口排序、在線(xiàn)調(diào)試增強(qiáng)等
Knife4j 配置關(guān)鍵要點(diǎn)
1.Spring MVC 路徑匹配策略配置
關(guān)于Knife4j需要注意一點(diǎn)的是需要在yml添加
spring: mvc: pathmatch: matching-strategy: ant_path_matcher profiles: active: dev
2. 掃描包與路徑分層配置
通過(guò) SwaggerConfig 類(lèi)指定掃描范圍,按業(yè)務(wù)模塊分層管理接口:
對(duì)于掃描器需要注意下面的包
二、如何前端與后端對(duì)接
1.axios是什么?
axios是一個(gè)基于Promise的HTTP客戶(hù)端,用于瀏覽器和Node.js環(huán)境。它支持發(fā)送異步HTTP請(qǐng)求,并提供了攔截請(qǐng)求/響應(yīng)、轉(zhuǎn)換請(qǐng)求/響應(yīng)數(shù)據(jù)、取消請(qǐng)求等功能。
2.安裝方式
使用 npm: npm install axios 使用 bower: bower install axios 使用 yarn yarn add axios 使用 cdn: <script src="https://unpkg.com/axios/dist/axios.min.js"></script>
前端
如果文件是JavaScript ,myAxios.js
如果文件 TypeScript。myAxios.ts
新建plugins文件夾,新建myAxios.ts文件。
// Set config defaults when creating the instance //自定義實(shí)例默認(rèn)值 import axios from "axios"; const myAxios = axios.create({ baseURL: 'http://localhost:8080/api' }); //攔截器 // 添加請(qǐng)求攔截器 myAxios.interceptors.request.use(function (config) { // 在發(fā)送請(qǐng)求之前做些什么 console.log("請(qǐng)求發(fā)送了",config) return config; }, function (error) { // 對(duì)請(qǐng)求錯(cuò)誤做些什么 return Promise.reject(error); }); // 添加響應(yīng)攔截器 myAxios.interceptors.response.use(function (response) { // 對(duì)響應(yīng)數(shù)據(jù)做點(diǎn)什么 console.log("請(qǐng)求收到了了",response) return response; }, function (error) { // 對(duì)響應(yīng)錯(cuò)誤做點(diǎn)什么 return Promise.reject(error); }); export default myAxios;
如何實(shí)現(xiàn) Axios 的請(qǐng)求重試機(jī)制?
核心實(shí)現(xiàn)思路:
在響應(yīng)攔截器中捕獲錯(cuò)誤,判斷是否需要重試(如狀態(tài)碼 5xx、網(wǎng)絡(luò)超時(shí));
使用遞歸或定時(shí)器實(shí)現(xiàn)重試,搭配指數(shù)退避策略控制間隔;
通過(guò)計(jì)數(shù)器限制最大重試次數(shù),超過(guò)則拋出異常。
三、分布式session是花里胡哨還是什么?
在傳統(tǒng)單體架構(gòu)中,Session通常存儲(chǔ)在服務(wù)器內(nèi)存中,用戶(hù)請(qǐng)求由單一服務(wù)器處理,不存在Session共享問(wèn)題。但在分布式系統(tǒng)中,多臺(tái)服務(wù)器共同處理請(qǐng)求,
解決跨服務(wù)器的會(huì)話(huà)共享問(wèn)題。
我就以redis分布式Session實(shí)現(xiàn)登錄的原理來(lái)展開(kāi)介紹。
1.登錄:生成Session標(biāo)識(shí)與數(shù)據(jù)存儲(chǔ)
- 用戶(hù)認(rèn)證:用戶(hù)提交密碼后,服務(wù)器進(jìn)行身份驗(yàn)證
- 生成唯一Session ID : 認(rèn)證通過(guò)后,服務(wù)器生成一個(gè)全局唯一的 id,作為Session的標(biāo)識(shí)
- 存儲(chǔ)Session數(shù)據(jù)到Redis:
- 將用戶(hù)信息封裝為JSON對(duì)象,以Session ID為鍵,存儲(chǔ)到Redis中
- 設(shè)置合理的過(guò)期時(shí)間,避免內(nèi)存浪費(fèi),實(shí)現(xiàn)自動(dòng)過(guò)期失效
代碼
- 設(shè)置合理的過(guò)期時(shí)間,避免內(nèi)存浪費(fèi),實(shí)現(xiàn)自動(dòng)過(guò)期失效
import javax.servlet.*; import javax.servlet.http.Cookie; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; /** * Session過(guò)濾器:驗(yàn)證請(qǐng)求的Session有效性 */ public class SessionFilter implements Filter { private final RedisSessionManager sessionManager = new RedisSessionManager("localhost", 6379); @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest httpRequest = (HttpServletRequest) request; HttpServletResponse httpResponse = (HttpServletResponse) response; // 1. 從Cookie中獲取Session ID String sessionId = extractSessionIdFromCookie(httpRequest); // 2. 驗(yàn)證Session UserInfo userInfo = sessionManager.getSession(sessionId); if (userInfo == null) { // 未登錄,重定向到登錄頁(yè) httpResponse.sendRedirect("/login"); return; } // 3. 將用戶(hù)信息存入請(qǐng)求屬性,供后續(xù)處理使用 httpRequest.setAttribute("currentUser", userInfo); // 4. 繼續(xù)請(qǐng)求處理 chain.doFilter(request, response); } /** * 從Cookie中提取Session ID */ private String extractSessionIdFromCookie(HttpServletRequest request) { Cookie[] cookies = request.getCookies(); if (cookies != null) { for (Cookie cookie : cookies) { if ("JSESSIONID".equals(cookie.getName())) { return cookie.getValue(); } } } return null; } }
實(shí)際項(xiàng)目中還需:
配置 Redis 集群連接
添加異常處理機(jī)制
實(shí)現(xiàn) Session 數(shù)據(jù)加密
配置 Web 容器注冊(cè)過(guò)濾器
添加日志記錄功能
總結(jié)
到此這篇關(guān)于Knife4j+Axios+Redis:前后端分離架構(gòu)下的 API 管理與會(huì)話(huà)方案的文章就介紹到這了,更多相關(guān)Knife4j Axios Redis內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Redis事務(wù)機(jī)制與Springboot項(xiàng)目中的使用方式
Redis事務(wù)機(jī)制允許將多個(gè)命令打包在一起,作為一個(gè)原子操作來(lái)執(zhí)行,開(kāi)啟事務(wù)使用MULTI命令,執(zhí)行事務(wù)使用EXEC命令,取消事務(wù)使用DISCARD命令,監(jiān)視一個(gè)或多個(gè)鍵使用WATCH命令,Redis事務(wù)的核心思想是將多個(gè)命令放入一個(gè)隊(duì)列中2025-03-03Redis實(shí)戰(zhàn)之Redis實(shí)現(xiàn)異步秒殺優(yōu)化詳解
這篇文章主要給大家介紹了Redis實(shí)戰(zhàn)之Redis實(shí)現(xiàn)異步秒殺優(yōu)化方法,文章通過(guò)圖片和代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作有一定的幫助,感興趣的同學(xué)可以自己動(dòng)手試一下2023-09-09Redis?數(shù)據(jù)恢復(fù)及持久化策略分析
本文將詳細(xì)分析Redis的數(shù)據(jù)恢復(fù)機(jī)制,持久化策略及其特點(diǎn),并討論選擇持久化策略時(shí)需要考慮的因素,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2024-06-06Redis源碼解析sds字符串實(shí)現(xiàn)示例
這篇文章主要為大家介紹了Redis源碼解析sds字符串實(shí)現(xiàn)示例,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-08-08Redis禁用命令、危險(xiǎn)命令及規(guī)避方法
這篇文章主要介紹了Redis禁用命令、危險(xiǎn)命令及規(guī)避方法,本文介紹了個(gè)非常致命的兩個(gè)命令以及用配置文件禁用這些命令的方法,需要的朋友可以參考下2015-06-06Redis分布式鎖及4種常見(jiàn)實(shí)現(xiàn)方法
本文主要介紹了Redis分布式鎖及4種常見(jiàn)實(shí)現(xiàn)方法,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2024-05-05