使用|使用 Beego 搭建 Restful API 项目
使用 Beego 搭建 Restful API 项目
1 环境准备 首先你需要在你的环境安装以下软件:
- go:编程语言运行环境
- git:版本控制工具
- beego:go 语言流行的开发框架
- bee:beego 配套的快速搭建工具
- 你喜欢的数据库:这里以 Mysql 为例
文章图片
? 1.2 git 官网下载地址:https://git-scm.com/downloads 1.3 beego 使用如下命令安装:
go get github.com/astaxie/beego
更多详情可参考官方文档:beego 的安装 1.4 bee 使用如下命令安装:
go get github.com/ranqiwu/bee
未使用官方生成工具,官方的不能使用go mod,GetAll方法未返回总条数 更多详情可参考官方文档:Bee 工具的使用 1.5 数据库 使用Mysql5.7,使用8.0时报异常 2 使用bee工具 bee 是 beego 框架自带配套的高效工具。 2.1 生成项目目录结构 如果你只是想搭建一个 api 服务,不带前端网页开发,可以使用如下命令:
bee api YOUR_PROJECT_NAME
就这样一个简单的命令,一个项目雏形就搭好了。 可以执行如下命令,跑起来看看。默认地址是:http://localhost:8080
bee run
如果你的8080端口被占用了,可以修改 conf/app.conf 文件调整端口号。如下所示,把端口调整到9000:
httpport = 9000
目录结构如下:
myproject
├── conf
│└── app.conf
├── controllers
│└── default.go
├── main.go
├── models
├── routers
│└── router.go
├── static
│├── css
│├── img
│└── js
├── tests
│└── default_test.go
└── views
└── index.tpl
8 directories, 4 files
2.2 连接数据库生成代码 你是不是想过生成目录结构之后,需要自己手动编写 model 和 controller。这里可以负责任的告诉你:常规的 CRUD 完全不需要你手动编写一行代码。以 mysql为例,只需运行如下命令即可:
bee api MyGoApi -tables="" -driver=mysql -conn="root:12345@tcp(127.0.0.1:3306)/company?charset=utf8"
运行命令之后你的目录,就会生成 Controller、Model 和 Router 文件。更多细致的调控可参考官方文档:Bee 工具的使用 - generate 命令 。 使用go mod管理包文件,使其项目可以脱离go path路径
go mod init MyGoApi
数据库驱动器需要你事先手动获取,命令如下:
go get github.com/go-sql-driver/mysql
2.3 生成Swagger文档 其实文档的大部分工作不论是在示例代码还是生成代码都已经给做了(留意控制器代码上的注释),你只需要修改下相应配置即可。在 beego 1.7+ 版本,只需要在 conf/app.conf 打开如下开关:
EnableDocs = true
做完之后,使用如下的命令跑你的项目:
bee run -gendoc=true -downdoc=true
- -gendoc=true 表示每次自动化的 build 文档
- -downdoc=true 就会自动的下载 swagger 文档查看器
文章图片
bee run时下载依赖包可能被墙,配置环境变量 GOPROXY:https://athens.azurefd.net ?
文章图片
【使用|使用 Beego 搭建 Restful API 项目】转载于:https://www.cnblogs.com/shi2310/p/10900328.html
推荐阅读
- 由浅入深理解AOP
- 【译】20个更有效地使用谷歌搜索的技巧
- mybatisplus如何在xml的连表查询中使用queryWrapper
- MybatisPlus|MybatisPlus LambdaQueryWrapper使用int默认值的坑及解决
- MybatisPlus使用queryWrapper如何实现复杂查询
- 六步搭建ES6语法环境
- iOS中的Block
- Linux下面如何查看tomcat已经使用多少线程
- 使用composer自动加载类文件
- Beego打包部署到Linux