| 注册
请输入搜索内容

热门搜索

Java Linux MySQL PHP JavaScript Hibernate jQuery Nginx
jopen
9年前发布

基于beego创建Restful风格的API项目及API文档自动化

原文  http://www.cnblogs.com/huligong1234/p/4707282.html
 

本文演示如何快速(一分钟内,不写一行代码)的根据数据库及表创建一个Restful风格的API项目,及提供便于在线测试API的界面。

一、创建数据库及数据表(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');

二、创建golang及beego环境

三、通过数据库创建Restful风格API项目

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

四、API文档自动化

>>cd ./jeedev-api  >>bee generate docs  >>bee run watchall true  //访问 <http://127.0.0.1:8080/docs> 即可看到自动化生产的API文档

 

基于beego创建Restful风格的API项目及API文档自动化

五、集成Swagger UI,在线提供Restful风格的测试接口和数据

*Swagger UI是一款RESTFUL接口的文档在线自动生成+功能测试功能软件。官网 http://swagger.io

5.1 手动下载swagger到项目目录

  • 下载beego提供的swagger包,

    解压至项目目录

  • 或者到官方地址 下载Swagger-UI, 把该项目dist目录下的内容拷贝到项目的swagger目录下,修改index.html中的默认的url为 http://127.0.0.1:8080/docs

5.2 访问 http://127.0.0.1:8080/swagger

基于beego创建Restful风格的API项目及API文档自动化

六、代码示例

参考资料:

 本文由用户 jopen 自行上传分享,仅供网友学习交流。所有权归原作者,若您的权利被侵害,请联系管理员。
 转载本站原创文章,请注明出处,并保留原始链接、图片水印。
 本站是一个以用户分享为主的开源技术平台,欢迎各类分享!
 本文地址:https://www.open-open.com/lib/view/open1438910666739.html
WEB服务/RPC/SOA RESTful