欧美成人午夜精品久久久,国产?V天堂一区二区三区,欧美精品va在线观看,亚洲一区二区三区免费在线观看,av无码精品一区二区久久,欧美性爱视频不卡一区三区,欧美乱人伦视频在线观看,国产一级牲交高潮

ARTICLE DETAIL

資訊詳情

深耕商務(wù)建站與企業(yè)官網(wǎng)運(yùn)營(yíng)的一線實(shí)戰(zhàn)洞察。

Spring Boot 接口文檔最佳實(shí)踐:ShowDoc 私有化部署與自動(dòng)化同步

Spring Boot 接口文檔最佳實(shí)踐:ShowDoc 私有化部署與自動(dòng)化同步 1. 先理解 ShowDoc 在 Spring Boot 開發(fā)里到底是什么角色做后端最煩的事情里維護(hù)接口文檔絕對(duì)能排進(jìn)前五。我之前在某團(tuán)隊(duì)接手一個(gè)訂單服務(wù)代碼里接口全有但文檔還停留在上一任同事離職前的 Word 版本前端聯(lián)調(diào)時(shí)對(duì)著舊文檔問這個(gè)參數(shù)明明沒傳啊我一看代碼字段早改名了。就是從那時(shí)候開始我把 Spring Boot API 接口文檔的維護(hù)方式換成了 ShowDoc。這篇東西不是官方教程是我從部署到落地再到團(tuán)隊(duì)一起用起來的全過程記錄適合正在糾結(jié)要不要上文檔工具的后端開發(fā)也適合剛把 ShowDoc 裝起來但不知道怎么接入 Spring Boot 的讀者。1.1 ShowDoc 到底是個(gè)什么工具ShowDoc 從產(chǎn)品形態(tài)上說是一個(gè)私有化、可部署的在線文檔系統(tǒng)。它最大的特點(diǎn)不是生成接口文檔而是什么文檔都能往里放。你可以新建一個(gè)接口項(xiàng)目用 Markdown 或富文本維護(hù)每個(gè)接口的 URL、header、請(qǐng)求體、返回示例、錯(cuò)誤碼也可以另開一個(gè)目錄把數(shù)據(jù)庫字段字典、環(huán)境配置說明、部署手冊(cè)全部整理進(jìn)去。對(duì) Spring Boot 項(xiàng)目來說一個(gè)好的接口文檔工具需要滿足三個(gè)條件第一能承載自動(dòng)生成的內(nèi)容第二能支持團(tuán)隊(duì)在線編輯和評(píng)論第三能控制訪問權(quán)限。ShowDoc 恰好三點(diǎn)都占。它不像 Swagger UI 那樣只能展示 Swagger 注解生成的結(jié)果也不像某些以調(diào)試為核心的工具那樣只注重能不能調(diào)通它更像一個(gè)圍繞接口資料的內(nèi)部 Wiki接口信息只是其中一類頁面。1.2 和 Word、Swagger UI 的真實(shí)對(duì)比我在實(shí)際項(xiàng)目里用過 Word、Swagger UI、ShowDoc 三種方式體驗(yàn)差別很大。Word 文檔的問題是完全沒有強(qiáng)約束。誰改了代碼不更新 Word沒人知道多人同時(shí)編輯時(shí)版本互相覆蓋文檔里寫詳見 XX 文檔最后根本找不到。Swagger UI 的問題是能看不能用。它確實(shí)能根據(jù)注解實(shí)時(shí)生成接口列表也能在線調(diào)試但字段說明、業(yè)務(wù)含義、錯(cuò)誤碼意思、數(shù)據(jù)字典這些靠注解很難寫清楚而且一旦項(xiàng)目多了Swagger UI 的導(dǎo)航會(huì)變得非常難用還經(jīng)常遇到跨域問題。ShowDoc 的價(jià)值在于把這幾種工具的長(zhǎng)處合到一起接口列表從 OpenAPI 數(shù)據(jù)導(dǎo)入字段說明、錯(cuò)誤碼、更新記錄靠編輯頁面補(bǔ)充訪問權(quán)限按項(xiàng)目劃分歷史版本還能找回。我用下來最直觀的感受是前端拿到的不再是一堆 JSON schema而是一份他們自己能看懂的接口使用說明。1.3 哪些項(xiàng)目適合選 ShowDoc不是所有團(tuán)隊(duì)都適合。如果是單機(jī)小 Demo直接看 Swagger UI 就夠如果團(tuán)隊(duì)規(guī)模很大已經(jīng)在用一體化 API 管理平臺(tái)也沒必要再引入 ShowDoc。ShowDoc 最合適的場(chǎng)景是接口數(shù)量中等幾十到幾百個(gè)、前后端協(xié)作流程還沒完全規(guī)范化、需要把接口文檔放在公司內(nèi)網(wǎng)、還需要有人能編輯權(quán)限的團(tuán)隊(duì)。我現(xiàn)在的團(tuán)隊(duì)就是用 Spring Boot 做微服務(wù)每個(gè)服務(wù)一個(gè)工程ShowDoc 按服務(wù)建項(xiàng)目實(shí)踐了半年效果比之前好太多。2. 部署 ShowDoc 服務(wù)我推薦私有化 Docker 方案ShowDoc 官方提供在線版但介于接口文檔通常帶有業(yè)務(wù)信息我不太建議把公司內(nèi)部接口丟給第三方。私有化部署是最穩(wěn)妥的選擇而 Docker 方案最省心。2.1 一條命令跑起來如果你服務(wù)器上已經(jīng)裝好 Docker啟動(dòng) ShowDoc 其實(shí)就是一句命令docker run -d \ --name showdoc \ --restartalways \ -p 4999:80 \ -v /data/showdoc_data:/var/www/html/ \ showdoc/showdoc這條命令做了三件事把容器命名為 showdoc方便后續(xù)查看日志和啟停用--restartalways保證服務(wù)器重啟后容器自動(dòng)拉起把宿主機(jī)的/data/showdoc_data目錄掛載到容器 Web 根目錄這樣文檔數(shù)據(jù)不會(huì)隨容器刪除而丟失。啟動(dòng)完成后訪問http://服務(wù)器IP:4999走完初始化引導(dǎo)用默認(rèn)管理員賬號(hào)登錄并立即改掉密碼。這里特別提醒默認(rèn)端口 80 被很多人掛在公網(wǎng)上掃到過建議改成不常用端口再配合防火墻只放行內(nèi)網(wǎng) IP 訪問。2.2 數(shù)據(jù)備份恢復(fù)的完整做法ShowDoc 的數(shù)據(jù)存在 MySQL 和文件目錄里容器化部署后這些底層細(xì)節(jié)被隱藏了我們只要保證掛載目錄安全就行。我的備份策略很簡(jiǎn)單每天凌晨壓縮整個(gè)掛載目錄保留最近 7 天。tar -czf /backup/showdoc_$(date %F).tar.gz -C /data showdoc_data find /backup -name showdoc_* -mtime 7 -exec rm -f {} \;恢復(fù)操作也直接新服務(wù)器上把備份文件解壓到同樣的/data目錄再跑一遍 docker run 命令數(shù)據(jù)就回來了。我踩過一次坑是早期沒意識(shí)到掛載目錄的重要性升級(jí)容器時(shí)直接刪了容器數(shù)據(jù)全丟。后來所有 docker run 都帶上-v掛載這個(gè)教訓(xùn)比任何配置都重要。2.3 項(xiàng)目和權(quán)限規(guī)劃要提前做ShowDoc 安裝好后第一件事不是寫接口而是規(guī)劃項(xiàng)目結(jié)構(gòu)。我建議按服務(wù)域建項(xiàng)目比如用戶服務(wù)、訂單服務(wù)、商品服務(wù)而不是把所有接口混到一個(gè)項(xiàng)目里。一個(gè)項(xiàng)目對(duì)應(yīng)一個(gè) ShowDoc 項(xiàng)目權(quán)限好控制文檔也好維護(hù)。在 ShowDoc 后臺(tái)項(xiàng)目可以設(shè)置為私有項(xiàng)目然后手動(dòng)添加成員。角色我習(xí)慣只開兩種后端主程是編輯者其他人是只讀成員。前端同學(xué)一般不需要編輯權(quán)限他們需要的只是穩(wěn)定的只讀地址。如果遇到要臨時(shí)修改文檔的情況再提升權(quán)限避免誤操作污染文檔。這一步看似簡(jiǎn)單但對(duì)后面的自動(dòng)化同步很關(guān)鍵因?yàn)闄?quán)限規(guī)劃直接決定 API Key 的使用范圍。3. Spring Boot 接入 ShowDoc核心是把 Swagger JSON 變成同步任務(wù)ShowDoc 有一個(gè)很實(shí)用的能力對(duì)外開放接口允許你把外部系統(tǒng)生成的文檔內(nèi)容直接寫入指定項(xiàng)目。這就給 Spring Boot 項(xiàng)目提供了一個(gè)自動(dòng)化方案用 SpringDoc 生成 OpenAPI JSON再把 JSON 轉(zhuǎn)成 ShowDoc 需要的頁面結(jié)構(gòu)最后通過 ShowDoc 開放接口推送上去。3.1 為什么中間格式選 OpenAPI 而不是直接手寫市面上很多人誤以為用 ShowDoc 就等于放棄 Swagger。實(shí)際上兩者是配合關(guān)系。Spring Boot 項(xiàng)目里通過注解維護(hù)接口信息SpringDoc 會(huì)自動(dòng)生成/v3/api-docs的 OpenAPI JSON。這個(gè) JSON 是標(biāo)準(zhǔn)格式包含接口路徑、方法、參數(shù)、響應(yīng)體和說明。ShowDoc 支持導(dǎo)入 OpenAPI 格式數(shù)據(jù)也支持用開放接口創(chuàng)建頁面。我之所以選擇 OpenAPI 作為中間層是因?yàn)樗鼉蛇叢怀蕴濋_發(fā)時(shí)用注解IDE 能檢查文檔更新時(shí)由腳本把 JSON 轉(zhuǎn)換推送不用人去一個(gè)個(gè)復(fù)制參數(shù)。如果哪一天團(tuán)隊(duì)決定換文檔工具OpenAPI JSON 還能繼續(xù)導(dǎo)入別的平臺(tái)數(shù)據(jù)不會(huì)被綁死。3.2 Spring Boot 側(cè)配置 SpringDoc在 Spring Boot 工程里加入 springdoc-openapi 依賴后它自動(dòng)掃描 Controller 上的注解。下面是基礎(chǔ)配置springdoc: api-docs: enabled: true path: /v3/api-docs swagger-ui: path: /swagger-ui.html啟動(dòng)項(xiàng)目后訪問http://localhost:8080/v3/api-docs能看到一個(gè)很大的 JSON這就是 OpenAPI 數(shù)據(jù)。為了讓這個(gè) JSON 內(nèi)容夠完整Controller 類和方法上的注解要寫全稍后我會(huì)在第四節(jié)專門講字段規(guī)范。這里先記住一個(gè)原則注解里寫清楚的內(nèi)容會(huì)原樣進(jìn)入 ShowDoc注解里沒有的內(nèi)容后面就得靠手工補(bǔ)工作量大得多。3.3 同步服務(wù)的核心代碼ShowDoc 的開放接口邏輯是準(zhǔn)備好 API Key、API Token、項(xiàng)目 ID然后把文檔內(nèi)容 POST 上去。不同部署地址的開放接口路徑可能不一樣去后臺(tái)的開放 API頁面能看到當(dāng)前地址對(duì)應(yīng)的示例。我封裝的同步服務(wù)簡(jiǎn)化后是這樣Service public class ShowDocSyncService { private final RestTemplate restTemplate new RestTemplate(); Value(${showdoc.api-url}) private String apiUrl; Value(${showdoc.api-key}) private String apiKey; Value(${showdoc.api-token}) private String apiToken; Value(${showdoc.item-id}) private String itemId; public void syncFromSwagger(String swaggerJson) { // 這里把 OpenAPI JSON 轉(zhuǎn)換成 ShowDoc 的目錄和頁面結(jié)構(gòu) // 推薦的做法是遍歷 paths 節(jié)點(diǎn) // 每個(gè) tag 作為一個(gè)目錄每個(gè) pathmethod 作為一個(gè)頁面 ListMapString, Object catalogs Converter.toShowDocPages(swaggerJson); MultiValueMapString, String params new LinkedMultiValueMap(); params.add(api_key, apiKey); params.add(api_token, apiToken); params.add(item_id, itemId); params.add(data, JacksonUtils.toJson(catalogs)); ResponseEntityString response restTemplate.postForEntity(apiUrl, params, String.class); // 判斷 response body 中的狀態(tài)失敗則拋出異常 } }這個(gè)類的重點(diǎn)在Converter.toShowDocPages它負(fù)責(zé)把 Swagger JSON 里的paths和tags映射成 ShowDoc 頁面層級(jí)。比如一個(gè)用戶管理 tag 下有三個(gè)接口最終在 ShowDoc 里就是一個(gè)用戶管理目錄下面掛著三個(gè)接口頁面。轉(zhuǎn)換邏輯不難但要注意幾個(gè)問題。第一OpenAPI 里同一個(gè) path 可能對(duì)應(yīng)多個(gè) HTTP 方法比如/user/{id}有 GET 和 PUT頁面標(biāo)題要帶上[GET]前綴否則同名頁面會(huì)互相覆蓋。第二ShowDoc 的頁面內(nèi)容是 Markdown轉(zhuǎn)換時(shí)要把請(qǐng)求體、響應(yīng)體、參數(shù)表轉(zhuǎn)成 Markdown 表格才能保證前端閱讀體驗(yàn)。第三不要把所有接口塞到一個(gè)頁面按接口頁面拆分方便單獨(dú)維護(hù)。3.4 觸發(fā)方式手動(dòng)按鈕 CI 自動(dòng)同步同步代碼寫好后觸發(fā)方式我推薦兩個(gè)層面。開發(fā)階段寫一個(gè) Spring Boot 單元測(cè)試或一個(gè)ApplicationRunner啟動(dòng)時(shí)打一個(gè)開關(guān)需要時(shí)手動(dòng)調(diào)用 sync 方法。發(fā)布階段在 CI 構(gòu)建腳本里加一段請(qǐng)求讓測(cè)試通過后自動(dòng)執(zhí)行同步。# 假設(shè)同步服務(wù)本身也暴露了一個(gè)受保護(hù)的 HTTP 接口 /sync/api-docs curl -X POST http://localhost:8080/sync/api-docs \ -H Content-Type: application/json \ -d {secret:your-sync-token}這里有一個(gè)特別容易踩的坑同步接口不要不加保護(hù)地暴露到公網(wǎng)。用 ShowDoc 開放接口時(shí)API Token 本身是一個(gè)高權(quán)限憑據(jù)任何拿到它的人都能直接修改文檔。所以代碼倉庫里絕對(duì)不能提交真實(shí) token要用環(huán)境變量注入同步接口也要加一層自己的簽名。4. 讓文檔真正好用接口內(nèi)容規(guī)范比工具選型更重要我見過不少團(tuán)隊(duì)工具從 Word 換到 ShowDoc文檔還是一團(tuán)糟。原因很簡(jiǎn)單工具解決的是放哪不解決寫什么。Spring Boot 接口文檔要讓人愿意看核心是把字段、返回值、錯(cuò)誤碼這三件事說清楚。4.1 統(tǒng)一返回結(jié)構(gòu)文檔里只放一個(gè)真實(shí)示例很多 Spring Boot 項(xiàng)目用ResultT包一層這沒問題但接口文檔里最常見的錯(cuò)誤是所有接口的返回示例都寫成{code:0, message:成功, data:{}}data 里面到底長(zhǎng)什么樣完全沒說。前端拿到這種文檔還是得來問你。我的習(xí)慣是在 Controller 的注解里直接用具體響應(yīng)對(duì)象讓生成的 OpenAPI JSON 里能看到 data 的結(jié)構(gòu)。比如Operation(summary 查詢訂單詳情) GetMapping(/order/{id}) public ResultOrderDetailVO getOrder(PathVariable Long id) { return Result.success(orderService.getDetail(id)); }然后在OrderDetailVO的每個(gè)字段上寫Schema(description 訂單狀態(tài)0-待支付1-已支付2-已取消)。這樣 Swagger JSON 里的字段說明完整同步到 ShowDoc 后前端就能直接看到 data 結(jié)構(gòu)而不是一個(gè)空的{}。4.2 字段說明的五個(gè)必填項(xiàng)寫字段說明時(shí)我要求團(tuán)隊(duì)每個(gè)字段至少回答五個(gè)問題字段名是什么類型是什么string / integer / boolean / object / array是否必傳取值范圍或枚舉含義一個(gè)真實(shí)可用的示例值。舉個(gè)例子訂單狀態(tài)如果只寫狀態(tài)兩個(gè)字前端大概率搞不清楚如果寫成訂單狀態(tài)可選值1待支付、2已支付、3已取消示例2聯(lián)調(diào)效率會(huì)高很多。這些內(nèi)容都可以直接寫在Schema注解里。需要注意注解里的example屬性會(huì)進(jìn)入 OpenAPI JSONShowDoc 轉(zhuǎn)換后也可以保留所以示例值一定要填別嫌麻煩。4.3 錯(cuò)誤碼單獨(dú)維護(hù)一個(gè)頁面HTTP 狀態(tài)碼和業(yè)務(wù)錯(cuò)誤碼是兩碼事。很多接口返回 HTTP 200但業(yè)務(wù) code 是 10001 表示訂單不存在。如果文檔里不把業(yè)務(wù)錯(cuò)誤碼列清楚前端同事只能靠猜。我在 ShowDoc 項(xiàng)目里固定建一個(gè)錯(cuò)誤碼說明目錄用 Markdown 表格維護(hù)所有業(yè)務(wù) code、含義、建議處理方式。這個(gè)目錄用腳本自動(dòng)同步時(shí)不要覆蓋保留給人工維護(hù)。錯(cuò)誤碼的規(guī)范要用排除法所有接口共用一個(gè) code 字段不要某個(gè)接口返回success、另一個(gè)接口返回status這種不一致是文檔大忌。4.4 目錄結(jié)構(gòu)要有頭腦不要全部堆在頂層ShowDoc 的項(xiàng)目頁面是按目錄組織的。目錄建議按業(yè)務(wù)模塊而不是Controller 類來建。比如訂單服務(wù)下面分訂單查詢訂單操作售后流程這樣前端按業(yè)務(wù)場(chǎng)景找接口比按類名一個(gè)一個(gè)翻要快。另外我會(huì)給每個(gè)模塊目錄配一個(gè)使用說明頁面寫清楚這個(gè)模塊的業(yè)務(wù)背景、通用 header、必填 token、分頁規(guī)則。這類頁面用自動(dòng)化腳本創(chuàng)建一次就不動(dòng)了后續(xù)手工補(bǔ)充。把自動(dòng)同步生成的頁面和手工維護(hù)的頁面分開是防止腳本覆蓋人工內(nèi)容的最后一道防線。5. 團(tuán)隊(duì)協(xié)作中真正提升效率的四個(gè)習(xí)慣ShowDoc 安裝后如果只是一個(gè)人上傳文檔那它只是一個(gè)網(wǎng)盤。要讓它發(fā)揮價(jià)值必須把它嵌進(jìn)團(tuán)隊(duì)的工作流里。5.1 訪問權(quán)限要分清API Key 也要分級(jí)別給前端同學(xué)分配只讀賬號(hào)而不是把項(xiàng)目鏈接直接扔到群里讓大家匿名訪問這是我對(duì)團(tuán)隊(duì)的最低要求。只讀賬號(hào)的好處是可追溯、可撤銷新人進(jìn)來給他開賬號(hào)有人離職直接禁用不用換整個(gè)項(xiàng)目鏈接。對(duì)自動(dòng)化同步用的 API Key 也要單獨(dú)建一個(gè)機(jī)器人賬號(hào)不要拿管理員的 Key 去寫腳本。這樣就算腳本里的 Key 泄露權(quán)限只影響指定項(xiàng)目不會(huì)波及整個(gè) ShowDoc 服務(wù)。這個(gè)問題容易被忽視我見過有團(tuán)隊(duì)把管理員 token 直接寫在前端代碼里最后整個(gè)文檔庫都被人清空了。5.2 Mock 數(shù)據(jù)與并行開發(fā)后端接口還沒寫完時(shí)前端最痛苦的是沒有數(shù)據(jù)可以聯(lián)調(diào)。ShowDoc 的頁面內(nèi)容本身就是 Markdown可以在里面維護(hù)一份完整的返回示例前端照著示例寫死數(shù)據(jù)先開發(fā)頁面。等后端好了再切換真實(shí)接口大部分邏輯不用改。這個(gè)方法比單獨(dú)搭 Mock 服務(wù)更輕量。我在實(shí)踐中的體會(huì)是Mock 服務(wù)適合接口數(shù)量大、團(tuán)隊(duì)已經(jīng)有一套流程的場(chǎng)景而 ShowDoc 加約定返回示例的方式適合中小團(tuán)隊(duì)讓前后端先對(duì)齊數(shù)據(jù)結(jié)構(gòu)。關(guān)鍵點(diǎn)在于返回示例必須寫的是真實(shí)數(shù)據(jù)結(jié)構(gòu)不能為了示例好看而編一個(gè)和實(shí)際代碼不一致的字段。否則前端按示例寫的數(shù)據(jù)結(jié)構(gòu)到了聯(lián)調(diào)階段全部要返工比沒有 Mock 更糟。5.3 把文檔更新動(dòng)作放進(jìn)發(fā)布流程最容易老化的文檔就是沒人主動(dòng)去更新的文檔。我現(xiàn)在要求只要后端接口有變更代碼合并之前必須把同步腳本跑一遍。這樣才能保證線上文檔和代碼是同一版本。你在 CI 里加一個(gè)步驟構(gòu)建成功后調(diào)用同步接口發(fā)布沒成功文檔就不會(huì)更新這個(gè)聯(lián)動(dòng)幫團(tuán)隊(duì)省了很多心。CI 腳本里要注意同步接口有網(wǎng)絡(luò)延遲建議加超時(shí)和重試。另外ShowDoc 同步過程是整體更新還是增量更新取決于你轉(zhuǎn)換器的實(shí)現(xiàn)我這邊是用按目錄重建的方式只更新自動(dòng)生成目錄下的頁面所以即使同步失敗ShowDoc 上還有上一次的舊數(shù)據(jù)不至于頁面全空。5.4 文檔變化主動(dòng)通知不要等前端來問ShowDoc 本身不一定有很復(fù)雜的消息通知能力但這不影響我們做變更通知。同步腳本執(zhí)行成功后可以在最后調(diào)用一個(gè)通知地址把本次變更的接口清單發(fā)給協(xié)作群。我習(xí)慣在轉(zhuǎn)換器里記錄本次變更的路徑和方法拼成一段簡(jiǎn)短文本。這樣前端不用天天刷新文檔頁面看有沒有更新后端在群里說一聲文檔已同步order 模塊新增了下單接口大家自然知道。通知邏輯不要放在同步接口內(nèi)部因?yàn)橥浇涌诳赡鼙欢啻斡|發(fā)應(yīng)該放在調(diào)用方CI 的任務(wù)里或者在同步接口返回結(jié)果后單獨(dú)發(fā)一次通知。這個(gè)細(xì)節(jié)能避免前端收到重復(fù)打擾。6. 兩年用下來我遇到的坑和最終建議每個(gè)工具都有一套看起來很美的文檔但真正的價(jià)值藏在坑里。最后這部分全是我的真實(shí)經(jīng)歷。6.1 四個(gè)最容易讓人崩潰的問題第一個(gè)坑是升級(jí)容器丟數(shù)據(jù)。我早期用 docker run 部署時(shí)沒掛載目錄后來官方鏡像升級(jí)我直接把容器刪了重建結(jié)果所有文檔全部清空。解決辦法上面寫過掛載目錄 定時(shí)備份雙保險(xiǎn)。第二個(gè)坑是 API Key 泄露。某次代碼審查發(fā)現(xiàn)同步腳本里的 token 被硬編碼在配置文件中而且配置文件不小心被提交到了倉庫。雖然事后改了 token但窗口期內(nèi)知道 token 的人都能改文檔很難追責(zé)?,F(xiàn)在所有密鑰一律走環(huán)境變量倉庫里只放占位符。第三個(gè)坑是自動(dòng)同步覆蓋了手工補(bǔ)充。用了轉(zhuǎn)換器后腳本會(huì)把整個(gè)目錄重建手工維護(hù)的備注被沖掉過一次。后來我把自動(dòng)生成的頁面和手工維護(hù)頁面放在不同目錄腳本只處理帶自動(dòng)生成標(biāo)記的目錄。第四個(gè)坑是文檔看起來全但沒講清。打開頁面接口路徑、參數(shù)類型都有但沒有示例值、沒有枚舉含義前端依然要在群里問。這屬于內(nèi)容規(guī)范問題不是工具問題解決方法是把 4.2 節(jié)五個(gè)必填項(xiàng)作為 Code Review 的一部分后端寫完接口自己先打開 ShowDoc 看一眼再提交。6.2 和其他方案比ShowDoc 的定位在哪里我不否定其他 API 文檔工具但每個(gè)工具的側(cè)重點(diǎn)不同。拿我們常用的對(duì)比維度看對(duì)比維度ShowDocSwagger UI 模式一體化調(diào)試管理平臺(tái)部署成本較低Docker 即可隨應(yīng)用部署較高通常要引入中心化服務(wù)自動(dòng)化程度靠 OpenAPI 轉(zhuǎn)換 開放接口本身自動(dòng)生成支持多渠道導(dǎo)入在線調(diào)試較弱不擅長(zhǎng)調(diào)試較好直接試接口很強(qiáng)集環(huán)境、斷言、集合團(tuán)隊(duì)協(xié)作權(quán)限、目錄、成員管理完善無權(quán)限概念偏平臺(tái)化適合較大團(tuán)隊(duì)私有化方便適合內(nèi)網(wǎng)隨服務(wù)內(nèi)網(wǎng)部署看版本多需商業(yè)授權(quán)如果你們團(tuán)隊(duì)接口數(shù)量多到需要集合管理、調(diào)試、Mock、自動(dòng)化測(cè)試那一體化管理平臺(tái)可能是更好的選擇。但對(duì)大部分中小團(tuán)隊(duì)ShowDoc 的輕量、私有化、配合 OpenAPI 自動(dòng)同步已經(jīng)能解決 80% 的問題。工具換得越頻繁團(tuán)隊(duì)對(duì)文檔必須更新的敬畏感越低。6.3 我給正在入門的人三條建議第一條先部署再談規(guī)范。把 ShowDoc 跑起來手動(dòng)維護(hù)兩個(gè)接口試試手感比空想一個(gè)月都有效。第二條接入自動(dòng)同步前先把 Swagger 注解補(bǔ)完整否則自動(dòng)化推上去的也是垃圾內(nèi)容。第三條接受 ShowDoc 的不完美它不是一個(gè)在線調(diào)試器它是團(tuán)隊(duì)的知識(shí)庫你需要讓它展示內(nèi)容而不是承擔(dān)所有接口工具的角色。我現(xiàn)在團(tuán)隊(duì)里的日常流程就是Spring Boot 代碼就是規(guī)范SpringDoc 負(fù)責(zé)生成 OpenAPI JSON轉(zhuǎn)換器負(fù)責(zé)把 JSON 變成 ShowDoc 頁面CI 負(fù)責(zé)在發(fā)布后自動(dòng)同步前端在 ShowDoc 上看文檔、在協(xié)作群里接收變更通知。如果你也準(zhǔn)備把 ShowDoc 引入團(tuán)隊(duì)別追求一步到位。先把服務(wù)跑起來找兩個(gè)真實(shí)接口維護(hù)出示例然后讓前端把 Word 扔掉再慢慢加自動(dòng)化。工具永遠(yuǎn)不是重點(diǎn)重點(diǎn)是團(tuán)隊(duì)愿不愿意把接口信息當(dāng)成代碼的一部分去維護(hù)。
返回列表
PREV
查看更多資訊
NEXT
返回資訊列表
久久久.COM| 日逼免费视频| 一级操逼大片| 五月丁香偷拍| 色五月在线视频观看| 激情久久网 | 99热九九在线| 九九99九九99九九99视频网| 99热色在线精品| 99日韩| WWW.久久.COM| 99热伊人| 色九网| 五月色无码| 7777久久亚洲中文字幕| 97五月天| 思思热在线播放| 婷婷五月中文字幕国产| 新99思思视频| 伊人婷婷青青cao| 丁香五月桃花在线激情综合| 国产99久久久国产精品免费看 | 无码 色| 欧美丁香五月97色| 97婷婷丁香五月天激情图片| 天天日色情| 婷婷永久在线| 色色五月天网站| 这里只有精品99www| 91九色视频在线观看| 日本精品人妻无码77777| 外国碰视频网站97| 另类小说五月天| 噜噜色天天开心| 激情亚洲五月| 色欲婷婷夜夜| 超碰A V在线| 久久99综合| 五月婷婷综合在线视频小说| 精品成人a v无码内射| 婷婷 激情 五月| 99久久久久久| 色婷婷欧美| 色婷九九九| 日韩成人精品中文字幕电影| 日本强伦片中文字幕免费看| 青草视频在线播放| 蜜桃成语时李时珍 免费| 丁香六月啪啪啪| 伊人啪啪网| 五月丁香亚洲五月| 情情五月天色| 99热777| 五月婷婷色播网| 九九亚洲视频| 一区二区中文字幕| 五月色丁香综合| 激情綜合網址| 色色激情网| 91疯狂操操操操| 91九九精品| 丁香色婷婷色手机免费在线| 美女爆乳18禁www久久久久久| 五月婷婷无码| 丁香婷婷九月在线| 超碰在线个人观看| 天堂爱啪啪| 激情丁香五月AV| 黄色激情网站在线观看| 激情婷婷视频在线| 4438激情网| 97碰在线免费观看| 免费观看亚洲AV片| 久热这里只有精品6官网亚洲| 国产精品成人在线| 激情五月天婷婷免费观看| 大香蕉手机视频| 天天久久狠狠色综合| 久久精典| 日 日干 日日做| 日本va网站| 激情四射五月天偷偷看婷婷| 美女激情婷婷| 噜噜噜久久亚洲精品国产品91| 天天夜天天色天天| 99无码精品| 五月天婷综合| 99热在线看| 日本欧美成人片AAAA| 99色色网| 亚洲狠9| 一区操| 五月丁香六月婷婷的女人| AV变态另类一区二区| 色综合网页| www.婷婷五月天,com| 97操| 五月香蕉综合| www激情婷婷com| 丁香五月色| 色天堂A| 91久久久久久| 色啦啦视频| av免费在线观看0| 九九热最新| 久99999热视频在线观看免费| 超碰人妻公开在线| 久久婷婷五月天蜜桃| 伊人网欧美在线男人天堂五月丁香| 亚洲艹网| 激情五月综合亚洲另类| 69精品人人人人人人人人人| 99碰网站| 激情综合色| 丁香五月婷婷在线| 久热91| 操操综合网婷婷| 欧美日韩国产一区二区| 性色欲情 网站| 五月婷婷香蕉| 亚洲精品无码久久| 色综合久久8| 五月丁香999| 五月丁香在线国产| 伊人婷婷大香蕉| 少妇做爰免费视看片| 丁香五月天日韩无码| 色婷在线视频| 欧美va亚洲va在线播放| 天天日夜夜拍| 狠狠99| 五月色丁香综合| 狠狠色丁香婷婷基地| 亚洲小视频| www.91.com黄| 在线看av| 五月婷婷激情四月| 国产精品第一国产精品| 激情久久久| 婷婷色网站| 五月丁香在线观看| 97婷婷狠狠| 五月天激情图| 亚洲色婷婷| 色日本综合| 噜噜色五月| 亚洲另类婷婷五月综合| 思思热精品在线视频| 99情色五月天| 色色综合视频| 美女久久婷婷| 丁香五月综合图片在线观看| 精品人妻伦一二三区久久| 拍色综合| 亚洲日日操| 激情五月综合网最新| 色综合久久久无码中文字幕999| 婷婷天堂综合| 丁香蜜臀黄色婷婷五月天| 久久综合26p| 五月丁香五月丁香| www.99热视频| 婷婷亚洲日本| 人人摸人人澡人人| 97碰碰视频| 在线视频色五月| 超碰人人91| 亚洲a片免费观看| 人妻系列久久久久久久久久久 | 极品人妻VideOssS人妻| 伊人婷婷五月天| 色色色色网站| 五月丁香毛片| 琪琪色五月天| 天天开心天天色| 97超碰在线免费观看| 男人操女人高潮91视频| 久热中文字幕在线线观看| 色综合色| 色五月天网| 精品一区二区三区四区五区六区| 婷婷综合五月天激情| 综合激情婷婷| 五月丁香六月婷婷在线小说视频| 成人做爰黄A片免费看直播室男男| 色六月天天激情综合网| 久色激情| 色综合播放| 婷婷伊人中文字幕| 丁香激惜男女| 国产又爽又猛又粗的视频A片| 婷婷五月丁香五月| 丁香九月综合| h在线看免费版在线看| 久99久在线| 久久这里只有精品热在99| 看逼中文字幕| 日韩三级高清无码| 成人五月天丁香婷| 婷婷久久大香蕉| 99国产小视频2013| 亚洲精品又粗又大又爽A片| 热无码A∨| 欧美在线| 狠狠干青青草| 婷婷丁香婷婷97| 第四色五月激情网| 丁香五月综合网| 亚洲bt丁香五月天婷婷激情小说| 五月激情综合性爱| 九九热在线99| 婷婷五月丁香久久| 五月天久久网站| 99热99| 丁香婷婷激情| 干亚洲天堂| 五月天大香蕉av| 女人天堂 AV| 日本九九九九九九| 在线播放成人网站| 色五月首页| 97自拍99| 国产又黄又爽又色的免费| 狠狠999| 久久婷婷青青| 婷婷色五月激情| 另类图片激情五月天| 51精品国自产在线| 久婷婷婷| 婷婷六月天亚州| 影音先锋男人资源站一区二区| 五月丁香啪啪啪综合网| 射久久丁香五月| 五月天激情网址| 性爱综合网| 婷婷五月色网| 亚洲婷婷久久综合| 婷婷丁香18| 亚洲婷婷91丁香| 在线五月色播| 一区三区视频有限公司| 丁香六月婷| 色国产五月| 中文字幕丰满孑伦无码专区| 爱99干99| 色原狠狠综合| 秋霞影音91人妻久久| 激情五月天第四色| 一级片操逼视频| 99国产精品久久久久久久久久久 | 久久艹99| 操熟女成人网| 深爱五月婷婷开心中文字幕| 色婷另类| 五月四色激情| 粉嫩AV久久一区二区三区| 五月丁香婷庭在线| 久久婷婷五月国产色综合激情| 精品九九久久| 99人妻碰碰久久久禁片| 五月天色区| 久久成人人妻| 亚洲综合婷婷五月| 成人五月天婷婷| 99久热精品在线| 国产成人精品亚洲线观看| 日本婷婷| 五月婷视屏在线观看| WWW色五月天| 日本在线视频看se99| 色综合天天| 丁香九九九九| 六月天婷婷| 六月丁香啪| 人橾人| 丁香六月婷婷色XXXX| 久热只有精品| 欧美人妻一区二区| 伊人激情综合网| 这里只有精品9| 婷婷基地成人五月天| 激情婷婷久久| 99ri在线播放| 99热销国产这里有精品| 97香蕉人人在线观看| 超碰免费人| 久久伊人五月天| 99久久久免费| 欧美性爱五月天| 天天澡天天狠天天天做| 婷婷六月五月天综合| 综合激情五月丁香9999久久精| 亚洲另类婷婷综合| 久久五月综合| 婷婷激情五月天综合| 色射影院| 色综合99| 色色成人網| 狼人久草| 六月婷婷五月丁香首页| 丁香五月综合图片在线观看| 五月丁香色播| 激情久久综合网| 97久久香草精品视频| 色VA| 中文aV网| 亚洲第二AV| 狼人伊人干| jiujiuxiangjiaowang| 日韩成人精品中文字幕电影| 免费碰碰视频久| 婷婷五月天av小说| 亚洲午夜一区二区| 国产9色在线/日韩| 在线视频色五月| 五月激情五月丁香| 丁香五月在线视频黑人| 久久这里有精品视频| 亚洲色情网站| 亚美欧色影院| 玖玖99免费视频| 色女人久久| 美女精品一级不卡视频| 婷婷激情性爱| 五月婷婷基地| 岛国资源网| 婷婷五月色亚洲| 婷婷丁香五月高清| 亚洲熟女色| 日韩成人精品中文字幕| 色五月天婷婷| 丰滿爆乳一区二区三区| 五月丁香久久综合色| 青996青| 人妻久久婷婷| 五月丁香WWW| 激情都市五月天| 九九精品视频在线6| 日本激情五月天‘| 狠狠爱激情网| 荫道BBWBBB高潮潮喷| 超碰免费观看| 任你艹| 五月丁香综合精品| 99这里有精品视频| 五月综合久久| 婷婷黄色五月| 丁香五月综合久久八| 影音先锋 婷婷| 婷婷五月天播播| 欧美操人| 偷偷操九九| 中文字幕视频在线播放| 婷婷激情五月天亚洲综合| 久久久久人妻精选| 97色色色色色| 久久日九九| 欧美噜噜噜草| 夜夜干夜夜操| 99热这里只有精品9| 婷婷五月综合社区在线| 激情综合婷婷五月| 97丁香五月| 亚洲中文字幕网| 色吊操色妞| 久久综合中文| www.五月丁香| 超pen个人视频97| 超碰99热精品| 婷婷激情五月综合丁| 99在线视频精品| 黄桃AV无码免费一区二区三区| 激情婷婷黄色五月| 操逼福利视频| 亚洲男女激情| 五月天婷婷色色网| 丁香五月婷婷骚视屏| 婷婷伊人网| 人与禽A片啪啪| 婷婷色中文| 亚洲一区先锋影音| 日本99久久| 婷婷丁香五月社区亚洲| 玖玖在线资源视频| 色婷网| 情色五月天 网站| 激情小说婷婷小说| 97碰碰视频在线观看| 成人性生活免费观看。| 美臀自射自家人妻| 97色婷| 久久aaaaa| 五月婷婷成人w| EEUSS鲁片一区二区三区| 91性交在线播放| 亚洲国产精品成人免费一区久久久在线观看AAAA | 第四色色六月色综合| 激情五月天婷婷直播| 婷婷日欧美在线观看| 婷婷.com| www,婷婷五月天777me,com| 婷婷五月无码| 九九性视频| 久久色9| 成人五月丁香花| 亚洲VA欧美VA| 婷婷成人五月天成人文学| 国产无人区大片| 丁香五月激情啪啪| 亚洲一区二区色图-亚洲精品国产精品乱码-成人AV | 99九九在线视频| 9l视频自拍九色9l黑人| 五月天激情美女久久| 五月色综合| 大香蕉九九| 成人五月天丁香婷| 99热这里| 激情五月久久| 91婷婷在线| 色欲影香| 久久综合激情| 无码99| 99色在线视频| 99热色精品| 久久99网站| 色婷婷网| 99热9| 99精品在线| 丁香五月香蕉| 久久婷婷视频| 女人天堂av| 五月天婷婷综合网| 青青草婷婷综合五月| 国产在线aaa片一区二区99| 九月婷婷综合八月丁香在线观看| 国产精产国品一二三在观看| site:feetmall.com| 五月婷三级片| 噜噜噜噜综合在线| WWW免费视频碰碰碰碰| 国产九九一区二区三区| 91色久| 色五月av| 五月天另类小说久久小说网| 久热爱大香蕉在线蜜臀悦色 | 黄网免费观看| 婷婷五月天基地| 丁香五月天欧洲在线| 久久婷婷色| 狠狠操天天操综合| 欧美日本99| 免费看欧美成人A片无码 | 丁香婷婷久久激情| 991自拍视频| 伊人五月天| 猫咪伊人久久| 久久久久久久人妻| 亚洲小视频| 亚洲色婷婷五月天| 婷婷综合五月天| 激情亚洲色图片丁香综合| 操精品9| 久热免费| 9久精品| 免费看欧美成人A片无码| 99re在线这里只有精品视频首页| 色五月婷婷91| 99色色| 婷婷五月18永久免费视频| 99re视频在线| 国产精品国产成人国产三级| 日日干天天爽| 五月丁香激情综合啪| 久久您您综合网| 丁香婷五月天开心六月| 婷婷丁香六月影视| 99久久.www| 久久综合激情| renrencaoav| 九九99在线视频| 日本色婷婷| 六月婷婷久久大全| 激情深爱五月婷婷| 大香蕉人人网| 成人美女网| 激情五月丁香六月综合AVXXXX| 激情五月天婷婷免费观看| 婷婷五月综合性爱| 久久只有18视频| 精品草原久久视频| 五月丁香久久网| 91jiuseshunv| 97精品人人A片免费看| 婷婷色五天| 五月丁香六月婷婷免费| 五月丁香激情四射综合| 狠狠婷婷日韩| 99热在线观看| 久碰婷婷视频| 伊人狠狠综合| 99re最新地址视频| 九九精品少妇| 伊人婷婷福利网| 五月天激情亚洲| 六月丁香五月天| 这里只有精品,日韩视频| 九九精品热播| 色婷婷av综合网| 色五月激情五月开心五月| 天天激情欧美美女| 男人天堂亚洲综合| 深爱激情中文五月天av| 九九这里是免费的视频5| 五月精品99综合| 性爱久久| 九九色综合九九色| 激情图片婷婷丁香五月| 99色亚洲| 婷婷激情五月天视频在线| 狠狠五月激情在线| 噜噜噜噜噜在线| 97超级操操| www,99热在线观看| AAA级久久久精品| 深爱激情综合| 99热国产这里只有精品| 色五月亚洲| 五月婷在线播放| 呦呦视频无码播放| 中文不卡一二三区| 色色亚洲无码| 色五月婷婷狠狠撸| 亚洲国产婷婷色五月| 啪啪丁香五月| 色综合久久88色综合天天看| 日本免费91| www色哟哟| 五月丁香色停停啪啪啪| 精品欧美性爱超级爽| 五月天婷婷综合| 丁香五月天堂| www.99热| 全部老头和老太XXXXX| 99热都是精品| 亚洲五月天激情| 99这里有精品视频| 99综合视频一体| 激情开心五月天| 99热97| 四色五月婷婷| 97色干| 久久久久婷婷| BBWCUCKOLD精品熟妇| 欧美大肥婆大肥BBBBB| 嫩草AV久久伊人妇女超级A| www色婷婷| 99久热| 国产做爰视频免费播放| 人妻AV在线| 噼里啪啦在线观看免费完整版视频 | 天天日色情| 九九婷婷五月天| 黄色录像网点| AV在线二十六页| 人人草碰| 九九色欲网| av在线观看网站| 九月丁香| 婷婷激情五月天色| 五月丁香亚洲婷婷| 婷婷五月天AV在线| 99热网站| 色婷婷呢狠禁久禁| 五月天婷婷激情网| 就要爱综合| 五月丁香久久综合精品| 极品人妻VideOssS人妻| 色色网站| 青青草99re| 色婷婷久久综| 超黄亚洲瑟瑟网站| 婷婷日日夜夜| 内射综合网| 五月丁香久久| 大大香蕉综合在线| 丁香五月影视| 99惹精品视频| 影视av久久久噜噜噜噜噜三级| AV性爱在线| 日本久久激情| 久久久大香蕉| 深爱丁香激情| av在线免费播放| 五月婷婷大香蕉| 久久久.www| 黄色五月婷婷| 人人视频色| 九九热自拍| 中文字幕日本最新乱码视频 | 9久国产精品| www.色五月| 日韩啪图| 伊人久久激情图区五月| av人人干| 桃色成人网| 九九九九综合| 五月色影院| 六月丁香啪啪啪| WWW久| 婷婷综合五月激情| 婷婷五月综合网| 色综合视频在线| 级情九色| 综合五月丁香六月婷婷| 久久久久9久无码视频| 99自拍视频在线| 常久最新免费的色吊丝| 九九色逼| AV在线观看网站| 五月天婷婷在线播放免费| 五月天激情国产综合婷婷婷| 97色婷婷在线观看| 色综合色综合色综合| 精品久久99| A片一曲| 五月丁香六月婷婷网| 久久久亚洲精品一区二区三区浴池| 婷婷激情在线| 99热66| 久久33视频| 三十路磁力链接| 婷婷五月激情中文字幕| www.99婷婷| 丁香婷婷色五月激情综合| 色婷婷香蕉在线| 婷婷五月天成人动漫| 成人短视频在线| 91婷婷五月丁香碰| 欧美日韩AAA| 天天草女人| 五月激情网五月综合网| 五月天久久久| 丁香综合伊人| 九九Av| 久久欧洲久久| 狠狠色综合网| 国产精品久久99| 人妻人人操| 五月丁香亭亭操逼| 五月天综合久久| 色v综合网| 99热99美国在线观看| 日本123区日韩欧美不卡在线看| www.色擼擼.com| 激情五月天天| 色播五月丁香| 五月色丁香婷婷综合| 99日这里只有精品| 中文字幕成人日韩| 天天做夜夜爽| 五月丁香久久呀| 国产色网站| www.91在线观看| 五月婷亚洲精品AV天堂| 久久五月综合| 丁香五月婷婷啪啪| 激情五月网站| 欧美三级视频| 五月天激情网图片| 99九九在线精品热动漫| 欧洲毛片基地c区| 婷婷99| 五月综合视频| 9999色色色色| 操日本色| 黄色成人网站在线播放| 天天日天天舔天天摸 | 人人操人人操919999| 精品在线网站| 六月丁香啪| 国产真人做爰视频免费| 天天操天爱综合| 99精品综合在线| 天天舔天天爽| 婷婷99| 俺也去色| 99热在线观看精品免费| 五月丁香色婷婷色| 狠狠干综合| 丁香婷婷五色月| 丁香9月婷婷| 久久婷婷综合网| 五月花综合网| 天堂网亚洲色图| AV成人在线播放| 色婷婷狠狠| 无码人妻AV久久久一区二区三区| 丁香六月无码播放| 五月停亭六月,六月停亭的英语 | WwW色婷婷| 99热这里只有精品5| 丁香激情久久| 97啪在线观看视频| 狠狠五月激情丁香六月| 五月香蕉婷婷| www.激情com| 极品人妻VideOssS人妻| 玖玖热99| 97自拍视频在线| 99热在线这里只有精品| 婷婷狠狠操| 欧美色综合天天久久综合精品| 少妇人妻综合色6699| 久久伦乱| 密着浓厚中出乚交尾GvG935| 久久综合婷婷五月| 丁香五月综合福利视频导航| 五月间天堂综合| 六月色婷婷| 国产亚洲色婷婷久久99精品91| 这里只有精品视频在线观看免费| 人妻在线网站| 亚洲精品又粗又大又爽A片| 真实亲子乱子伦高清在线观看| 五月天婷婷xxx| 偷偷操九九| 婷婷五月天小说| 久久久无码精品成人A片小说| 六月丁婷婷| av在线免费网站 | 九九色热| 激情婷婷五月| 天天模,夜夜模夜夜爽| 另类伊人婷婷| 国产99久9在线+|+传媒| 色婷婷影视| 久久免费操| 涩涩涩.com| 狠狠色婷婷7| 伊人婷婷大香蕉| 五月激情婷婷偷拍| 99精品无码| 特黄三级片| 丁香美女五月天婷婷| 婷婷综合网伊人| 激情文学 综合 色| 人妻视频在线| 色爱综合五月| 91狠狠色丁香婷婷综合久久狠丁香综合久久精品 | AA片在线观看视频在线播放| 97综合在线| 99热在线播放| 亚洲综合婷婷六月丁香五月| 电影蜘蛛女| 99熟女视频| 999九九九久久久99HD| 婷婷99视频在线| 久久久久久欧美精品se一二三四| 色综合色五月| 超碰99资源站| 99热97| 丁香五月亚综合图片| 欧美在线操| 五月婷色色| 金品在线视频99| 五月婷婷久久爱| 欧美日韩成卜| av亚洲国产小电影| 亚洲激情综合| 久久激情五月| 久久婷综合| 久热超碰| 丁香六月啪啪| 精品久久艹| 亚洲热热视频| 天天日综合| 亚洲激情五月天| 婷婷金品综合视频| 91操碰| 五月婷婷中文字幕| 99这里只有精品|v| 色五月激情婷婷| 久操大香蕉| 超碰人人色| 99超级碰免费视频| 中美日韩成人在线| 色播婷婷五月天| 亚洲一级色电影| 99久久精品色老| 丁香六月婷婷综合| 五月丁香六月婷婷精品| 六月五月丁香五月欧美| 99无码免费视频| 色天天综合色| 婷婷深爱五月丁香网| 九色色| 一级性爱视频| 国产婷婷综合| 国产亚洲99久久精品| 99精品视频网| 成人无码精品1区2区3区免费看| 国产精品18久久久| 91人妻九色大屁股| 日本97在线看片| 色播五月综合网| 婷婷综合精品| 天天干夜夜操A片| 丁香五月狠狠综合欧美| 久久A区B区| 91色吧网| 狠狠狠狠狠| 99国产精品久久久久久久久久久| 另类五月激情| 97碰成超视频免费视频| 久久久999精品| 五月色丁香综合| 亭亭五月天黑人2014| 99热99热在线| 亚洲综合1024| 亚洲V国产V欧美V久久久久久| 内射 无码 伊人| 久婷婷五月综合欧美| 久热9| 九九在线免费观看| 色色色热热热| 久久婷婷综合五月天| 最近中文字幕在线中文视频| 六月丁香开心婷婷欧美| 五月婷婷中文字幕| 精品无码色欲AV| 人。妻久久| 色99在线视频| 婷婷伊人欧美| 99久在线视频| 欧洲综合视频在线观看。欧洲,亚洲综合食品在线观看。 | 97涩婷婷婷婷基地| 婷婷丁香激情综合色情| 欧美va视频不用播放器的va视频网| 涩涩涩.com| 婷婷五月天黄色| 亚洲在线免费成人| 久综合九| 色综合开心五月深爱五月| 六月婷婷综合| 天天操夜夜操| 五月天婷婷激情网| 激情婷婷五月女| 婷婷色色婷婷| 全部老头和老太XXXXX| 国产美女主播vip| 另类的婷婷| 久青草影院| 嫩BBB搡BBBB榛BBBB| 五月婷婷九九久久| 丁香五月成人论坛| 91干在线| 丁香六月婷婷激情| AV伊人青草丁香六月| 激情综合色播| 国产欧美日韩综合精品一区二区| ′久久99一| 亚洲 无码 中文字幕 中出| 欧美在线操| 久久这里只有精品视频15| 色色综合无码| 激情五月久久| 日韩一级一片内射视频4K| 91超碰人人操| 综合网天天| 99丁香婷婷综合网| 密黄站| 亚洲情色一区| 秋霞网在线免费基地五月婷婷丁香| 天堂爱爱| 99色综合| 欧美日韩成人在线观看| 婷婷亚洲色| 第九色区av天堂| 91成人品| 五月天婷婷AV| 在线观看欧美3区| 五月丁香啪啪啪啪| 97色在线| 99五月丁香丁| 色色色国产| 九九人人看| 日本五月视频| 91妻人人爽人人看片| 午夜色色色极品视频| 久久多色| 欧美色色色色色色色色色色| 色99网站| 久久久久五月丁香| 五月婷婷福利| 婷婷五月天桃花网| 色五月婷婷大| 99噜噜噜在线播放| 狠狠五月天婷婷| 日韩人妻无码专区| 天天操夜夜爽天天操| 久婷五月| 久久激情综合| 九月丁香| 1024人妻| 六月丁香五月婷婷| 丁香六月婷婷激情综合| 色色射| 五月丁香| 日韩一级片| 色一区高清| 九九在线精点品| 色丁香五月天射婷婷爱婷婷| 亚洲综合五月| 五月丁香六月婷婷啪啪综合| 天天插天天干| 五月丁香激情综合啪| 夜夜人妻五月天| 亚洲色网络| 伊人婷婷青青cao| 噜噜在线| 亚洲激情丁香五月基地| 日比网免费国产| 深爱丁香激情| 久久五月丁香综合| 五月婷婷综合久久| 午夜av网| 99色在线观看视频| 日韩啪| 99热综合| 激情婷婷五月黑人| 婷婷五月天淫荡| 婷婷丁香色情| 婷婷综合在线播放| 久激情网| 日日操夜夜爽白洁| 五月色情| 婷婷色欧美激情| 任你搞在线观看视频| 久久性爱视频| 色狠狠色| 成人做爰高潮A片免费视频| 99.色| 蜜乳AV成人| 日本色婷婷| 亚洲激情av| 丰满老熟妇BBBBB搡BBB| 亚洲色综合性| 日本毛片内射| 亚洲操操| 婷婷激情啪啪| 密乳Va| www狠狠| 久热中文字幕在线线观看 | 另类视频五月天| 99色1| 欧美久人人| 超碰在线99| 99热综合在线观看| 中文字幕+中文在线| 97干在线视频| 九九爱看亚洲| 色色五月天婷婷丁香| 婷婷激情五月| 国产精品色一哟哟| 成人电影AV在线观看| 丁香五月成人| 日本色色视频| www.久久| 久久久久久久,99精品视频| 97精品欧美91久久久久久久| 亚洲综合网激情小说| 欧美婷婷色五月网| 婷婷五月天综合在线| 色丁香婷婷| 成人精品在线| 波多婷婷久久| 成人在线网| 欧美天天干天天草| 综合久| 日韩av免费版| 婷婷色网| 婷婷播5月| 五月天合网| 亚洲AV另类| 天天日天天色| 婷婷玖玖五月天| 亚洲99手机免费看视频| 中文字幕,综合,91| av高清无码| 337p大胆噜噜噜噜噜91Av| 我要看激情五月天| 婷婷色色网| 久久天堂婷婷五月| 亚洲V国产V欧美V久久久久久| 亚洲成人av在线播放| 99高级会所久久| 婷婷五月色综合| 色啪久| 91一起操| 人人操人人爰人人一天天碰夜夜拍夜夜爽-中国A级毛片天天看天天谢… | 久热这里| 天天日夜夜爽。| 丁香五月花婷婷开心| 都市激情亚洲| 欧美在线ee日韩| 99热精品在线观看| 91人碰| 色色色国产| 久久在这里有精品| 九九五月天| 七月激情六月婷婷综合在线播放| 中字幕视频在线永久在线观看免费| 黄色成人网站在线播放| 五月天精品视频| 国产综合激情五月久久| 人人爱操| 日韩99视频| 加勒比久热| 五月停性愛| 亚洲爆乳无码精品AAA片蜜桃| 五月婷婷激情| 色噜噜狠狠一区二区三区| www.minyis.com【JT】国内CDN落地页保证转化QQ2101460746 | 五月婷婷六月丁香激情综合网| 国产在线黄色| 丁香五月停停基地| 日逼影音先锋AV男人资源站| 色欧美一级| 色婷婷五月天| 人人摸人人干| 丁香六月综合激情| 99热国内精品| 人人草人人舔| 精品人妻一区二区三区四区不卡在| SS丁香五月婷婷| 丁香婷婷六月天| 色色色综合视频| 97色色色色| 超碰AV在线| 亚洲在线资源| 欧美日韩成人免费在线| 成人毛片在线免费观看| 激情性爱网站| 欧美男女婷婷| 超碰99热在线观看| Www.se.久久| 久久久久久久,99精品视频| 五月婷婷电影院| 99超超碰| 欧美综合五月天婷婷tin| 成人精品视频99在线观看免费| 97人人干| 欧美顶级少妇做爰HD| 天天插天天插| 欧亚成人A片一区二区| 中文字幕欧美日韩VA免费视频| 日日夜夜狠狠| 97色吧| 国产午夜精品AV一区二区麻豆| 免费看欧美成人A片无码| 亚洲日韩一页精品发布| 亚洲无AV在线中文字幕| 99ree6| 99热99艹在线观看| 六月五月天婷婷涩播在线| 九九精品大香蕉| 狠狠狠狠草草| 丁香五月婷婷99| 日本婷婷在线| 综合玖玖性爱免费视频| site:wpjngj.com| 伊人在线婷婷草| 26uuu亚洲欧美| 99热亚洲精品| 99玖玖在线视频| 97色碰| 六月激情网| 伊人丁香在线| 九九热99精品| 任你搞网站| 99热欧美在线观看| 手机看片日日做夜夜| 天天做天天爱天天玩夜夜爽| 天天日,天天插| 丁香九月综合激情| 夜夜爽天天爽| 不卡在线视频| 色欧美日| 五月丁香啪啪网| www.久久五月天.com| va亚洲中文在线| 狠狠爱五月婷婷| 99久在线精品99re8| 91干婷婷| 色婷婷瘦婷婷日韩| 97人人射| 大伊久久| 七七色色综合| 97天堂| 国产人人操| 91超碰在线观看| 亚洲激情五月婷婷日日| 婷婷六月啪啪| 99A片| 日本在线播放97| 色九亚洲| 在线色五月婷婷| 婷婷八月丁香激情综合| 色色色综合网| 色99xx| 开心五月婷婷激情| 五月婷婷婷婷婷婷艺术| 超碰国产在线观看| 国产 码在线成人网站| 亚洲a片免费观看| 欧美日韩成人在线| 色丁香婷婷| 91婷婷| 先锋影音男人的天堂AV| 九九色影视| 这里只有精品在线免费视频| 九九色婷婷| 操精品9| 超碰精品在线| 日韩爱操视频| 久久色情| 久久玖玖综合| 婷婷六月天精品| 久久 婷婷 五月天| 91919191919久久成人视频| 99久久www| 青草热视频这里只有精品| 亲子乱AV一区二区三区下载| 99久久国产综合精品五月天喷水\| 色综合色五月| 综合一本道| 五月激情天| 亚洲AV网址| 五月丁香无码| 久热大香蕉| 五月丁香激情综合啪啪| 色综合性视频| 亚洲精品亚洲人成人网| 色婷婷色综合| 综合狠狠干| 狠狠干综合| 久久天堂精品| 五月天激情网页| 婷婷久久综合| 91婷婷色| 成人免费va| 国产成人精品一区二区三区视频 | 99热亚洲| 九色亚洲| 婷婷五月天激情在线观看 | 91精产一区三区免费观看| 久久99热精品a片在线观看| 成人va在线播放| 人人性久久| 国产五月天欧美色| 亚洲情综合五月天| 啪啪色激情五月天| www.maotanji.com| 日本少妇AA一级特黄大片| α久久| 91日韩在线| 亚洲激情av| 欧美在线97| 国产综合81p| 99色色色色| 1024在线一区| 综合激情网五月激情 | 九九精品自拍| 99色色| 天天综合91入口| 丁香 婷婷 亚洲 熟女| 久久综合99综合| 五月 丁香 欧美| 无码人妻少妇色欲AV一区二区 | 色婷婷久久视屏| 天天天天天日| 日本久碰| 久久人妻视步| 波多婷婷久久| 99热视精品| 99热99精品在线观看| 婷婷六月色情| 久久99最新地址| 色高清无码视频| 精品人妻午夜一区二区三区四区| 熟女乱论网| 欧洲色区| 久久久久综合激动五月天| 能看的av| 午夜性爱影视一区77| 欧美色色色| 五月婷婷亚洲| 亚洲爱婷婷| 开心五月激情网| 9九色首页| 婷婷久久五月天丁香| 天堂中文国产| 五月天激情四射| 噜噜噜噜婷婷五月天| 这里只有精彩视频| 色八月婷婷| 丰满女老板BD高清A片| 99色播| 婷婷丁香大香蕉| 色色亚洲五月天| 啪啪色区| 日韩性视频| 人人草成人视频| 欧美性色A片免费免费观看的| 五月丁香婷婷婷婷综合网| 久久受www免费人成| 尔尔AV一区| 久久与婷婷| 九九热最新视频| 日日干日日s| 丁香五月玖玖| 天天色天天日| 天天操B| 婷婷综合久久| 婷婷五月激情在线| 六月激情网| 婷婷综合久久| 啄木鸟黑丝一区二区| 美女被操一区二区| 五月婷视频| 五月婷婷综合网| 精品一二三区久久AAA片| 性生活视频98791| 丁香色影院| 超碰在线9| 91超碰在线观看| 久久久久婷婷五月热综合| 欧美日韩成卜| 色婷婷电影网| 婷婷在线播放av| 九九婷婷五月天| 播五月丁香三月婷婷| 99精品在线观看| 综合久久激情久久| 五月色丁香| 婷婷激情五月天综合| 91碰人人| 狠狠色噜噜狠狠狠狠综合| 六月婷婷狠狠| 91九色无码内射| 欧美这里只有精品| 66精品成人免费网站在线观看| 久久五月天网| 丁香五月影院| 天天色综网| 激情网站五月| 五月婷婷激情在线| 91九色视频| 色综合综合色| 天天综合网91| 丁香五月天AV在线 | 67194国产| 久久九九在线视频| 久久98| 九热av| 丁香五月欧美|