經過beego快速建立一個Restful風格API項目及API文檔自動化(轉)

經過beego快速建立一個Restful風格API項目及API文檔自動化

本文演示如何快速(一分鐘內,不寫一行代碼)的根據數據庫及表建立一個Restful風格的API項目,及提供便於在線測試API的界面。html


1、建立數據庫及數據表(MySQL)

#db--jeedev -- ---------------------------- -- Table structure for `app` -- ---------------------------- DROP TABLE IF EXISTS `app`; CREATE TABLE `app` ( `id` int(11) NOT NULL AUTO_INCREMENT, `create_date` datetime NOT NULL, `app_code` varchar(255) COLLATE utf8_unicode_ci NOT NULL, `app_name` varchar(255) COLLATE utf8_unicode_ci NOT NULL, `publish_date` date DEFAULT NULL, PRIMARY KEY (`id`), UNIQUE KEY `app_code` (`app_code`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci; -- ---------------------------- -- Records of app -- ---------------------------- INSERT INTO `app` VALUES ('1', NOW(), '100000', '神廟逃亡', '2015-08-06'); INSERT INTO `app` VALUES ('2', NOW(), '100001', '憤怒的小鳥', '2015-08-06');

2、建立golang及beego環境

3、經過數據庫建立Restful風格API項目

>>bee api jeedev-api -conn="root:123456@tcp(127.0.0.1:3306)/jeedev"

4、API文檔自動化

>>cd ./jeedev-api >>bee generate docs >>bee run watchall true //訪問 <http://127.0.0.1:8080/docs> 便可看到自動化生產的API文檔

文檔自動化

5、集成Swagger UI,在線提供Restful風格的測試接口和數據

*Swagger UI是一款RESTFUL接口的文檔在線自動生成+功能測試功能軟件。官網http://swagger.iomysql

5.1 手動下載swagger到項目目錄

5.2 訪問http://127.0.0.1:8080/swagger

swagger ui

6、代碼示例

參考資料:

相關文章
相關標籤/搜索