功能入口:API管理應用 / 公共資源菜單 / 智能 Mock 設置 二級菜單在編寫API文檔返回結果時,若參數字段和類型匹配智能Mock規則,系統則會自動填入對應的Mock值。該功能提供無感的快速mock值配置,減輕mock規則配置的工作負擔。
智能Mock的匹配規則分兩種類型:內置規則和自定義規則。
內置規則是一套完整的預置智能Mock規則,用户不可編輯具體的匹配規則,僅可整體啓用或停用。內置規則有助於用户快速使用智能Mock能力。
自定義規則是用户自定義自由配置的智能Mock匹配規則,用户可以根據個性化需求創建、編輯和刪除自定義規則。支持使用通配符、正則表達式、完全匹配的方式來匹配字段名。
開啓/停用內置規則
1、進入應用級公共資源內的智能mock設置,可看到自定義規則模塊和內置規則模塊。
2、在內置規則模塊右上角,有開啓/停用內置規則的切換按鈕。該按鈕默認開啓,點擊按鈕則工作空間內停用內置智能Mock規則。
3、點擊頁面標題下的保存按鈕,變更方可生效。
添加/編輯自定義規則
1、進入應用級公共資源內的智能mock設置頁。
2、在自定義規則模塊中,點擊底部最後一行中輸入對應的數據即可添加新的自定義規則:
- 數據類型:匹配的字段數據類型,必填。
- 匹配方式:用於確認字段名稱的匹配方式。默認為通配符,可選擇通配符、正則表達式、完全匹配三種方式。
- 匹配規則:可輸入字段名稱匹配表達式,必填。根據所選匹配方式輸入對應的名稱匹配表達式。
- 匹配大小寫:控制字段名稱匹配時是否大小寫敏感,默認為否。
- Mock 規則:支持輸入任意固定值或mockjs的佔位符。當字段匹配智能Mock規則的數據類型和字段名稱後,系統自動填入的mock值。
- 備註:用於標註説明該智能匹配規則,僅展示於智能mock設置頁。
- 操作:當前僅提供刪除操作。
3、完成自定義規則添加或編輯後,需點擊頁面標題下的保存按鈕才會生效。否則刷新頁面後當次編輯的數據會清空。
刪除自定義規則
1、進入應用級公共資源內的智能 mock 設置頁。
2、點擊對應自定義規則右側的刪除操作按鈕,即可進行刪除。
3、點擊頁面標題下的保存按鈕,變更方可生效。
規則優先級
- 智能Mock中,自定義規則的優先級大於內置規則。若某個字段同時滿足自定義規則和內置規則的匹配條件,則該字段的mock規則優先填入自定義規則的mock內容。(即自定義規則>內置規則)
- 新創建的自定義規則優先級更高。若某個字段同時滿足兩個自定義規則的匹配條件,則該字段的mock規則優先填入較新創建的自定義規則的mock內容。(即新自定義規則>舊自定義規則)