Katalon Studio之swagger中的API導入

 

約束條件：

swagger中必定要在註解@ApiOperation中設置nickname的惟一值，例如：
@ApiOperation(value="新增用戶",notes="添加用戶",nickname="adduser")
這是由於Katalon在解析swagger的json文件時，API命名是經過提取operationId這個鍵的值來自動生成的，若是不經過nickname對operationId進行惟一值設置，默認爲方法名稱+Using+請求方式
，例如：

"post": {
	"tags": [
		"部門管理"
	],
	"summary": "新增單個對象",
	"operationId": "addUsingPOST",
	"consumes": [
		"application/json"
	],
	"produces": [
		"*/*"
	],

當不一樣類均用add表明添加時，katalon自動生成的API將出現重名問題，不便於接口命名惟一性，所以建議進行約束。

swagger接口文件導出

swagger的正確打開方式實際上是api設計器，在接口設計階段開發人員可使用swagger Editor編寫API設計，評審經過後自動生成項目的api代碼框架，開發人員只須要在框架中編寫相關接口實現便可，不過現實工做中因爲各類緣由不少開發工程師在代碼編寫過程當中經過添加註解完成swagger。測試工程師能夠經過本身所負責項目的swagger服務自動獲取json格式的api文件，方法以下：
訪問項目http:IP/swagger-ui.html#/用於獲取api-docs路徑，以下圖所示：

在瀏覽器中輸入：http:IP/api/test/v2/api-docs，顯示swagger接口的json內容，以下所示：

將本界面的內容保存爲本地的json格式文件（建議使用chrome的FeHelper插件下載json文件）

 啓動KS，建立新項目，使用導入swagger的方式建立接口請求，以下圖所示：

在彈出的import swagger界面選擇剛導出的json文件，點擊OK按鈕，自動生成接口請求，以下圖所示：

雙擊任意一條請求，右側顯示該請求的相關配置參數，以下圖所示：

其中自動生成的請求全部的協議默認爲https，若是相關請求不是該協議須要手動修改，例如http（暫未找到解決方式）