## 簡介
* Swagger作為接口文檔工具接入springboot工程非常方便,只需maven繼承官方的jar,實現一個configuration就可集成完畢
* 但是對于有較多微服務的系統來說,一個服務一個文檔地址,便會覺得比較麻煩。這時候聚合文檔的解決方案出現了,將所有的微服務地址以swagger分組的形式展現,切換分組的時候就相當于直接切換了整個微服務。
* JPower對聚合文檔做了優化,提供了非常簡單、配置方便的解決方案,我們來看看具體如何操作。
## 如何配置
* 在nacos中配置好`jpower-api.yaml`文件。

* 在微服務服務工程引入common-swagger依賴即可

* 啟動jpower-api服務

## 訪問文檔
* 啟動工程訪問文檔聚合地址: http://localhost:18000/doc.html

* 點擊左上角的下拉框,我們可以看到已經配置好了4個不同的微服務文檔。

* JPower集成了swagger增強插件knife4j,并已經實現了鑒權的header頭,我們只需要再header頭中輸入鑒權接口返回的值即可。需要注意的是每個微服務模塊都需要設置header頭的值。設置heaer值之后訪問接口無需再配置鑒權的token

## 注意點
* swagger默認在生產環境 prod 下關閉無法使用,因為在生產環境暴露接口會非常危險,若需要開啟,可以到對應文件刪掉配置

* 每個服務都需要開啟knife4j配置,否則聚合文檔不會顯示服務接口,具體開啟文檔的配置如下:
~~~
#knife4j配置
knife4j:
#啟用
enable: true
~~~
## API直達
* swagger文檔直達:https://swagger.io/
* swagger增強插件knife4j有不少好用的功能,詳細說明和使用請查閱官方文檔:https://doc.xiaominfo.com/guide/useful.html
- 序言
- 開發環境準備
- 環境要求
- 環境安裝
- 基礎環境安裝
- Nacos安裝
- Sentinel安裝
- 插件安裝
- 導入工程
- 運行工程
- 工程測試
- JPower特性
- 系統啟動器
- 多終端令牌認證
- 系統鑒權
- 鑒權API
- 鑒權配置
- API權限配置
- 接口放行配置
- 數據權限
- redis緩存
- 動態網關
- 聚合文檔
- SaaS多租戶
- 概念
- 使用
- Xss防注入
- 日志記錄
- 操作日志&錯誤日志
- SQL打印
- feign請求日志&配置
- gateway日志
- 服務日志打印
- 導入導出
- 字典查詢
- 系統文件上傳下載
- 接口監控
- 代碼生成器
- 配置文件共享
- Mybatis過濾器
- 配置說明
- 高級實戰
- nacos動態配置
- Seata分布式事務
- 簡介
- docker啟動
- 微服務配置
- 微服務遠程調用
- 聲明式服務調用 Feign
- 熔斷機制 Sentinel
- sentinel流控
- 簡介
- 微服務配置
- 配置nacos對接
- APM監控&鏈路追蹤
- 簡介
- 安裝
- 微服務接入
- SpringBootAdmin監控
- ELK分布式日志追蹤系統
- ELK簡介
- ELK一鍵部署
- 微服務日志對接ELK
- JPower-Chat
- 配置說明
- 生產部署
- docker部署
- docker安裝
- docker-compose安裝
- harbor安裝
- 部署步驟
- 版本升級
- 1.0.1升級到2.0.0
- 2.0.0升級到2.0.2
- 2.0.2升級2.1.0
- 2.1.0升級到2.1.1
- 2.1.1升級到2.1.2
- 2.1.2升級到2.1.4