beego-mysql-redis-mongodb

beego-mysql-redis-mongodb

A web demo using Beego framework, with MongoDB, MySQL and Redis support.

这是一个基于 Beego 框架构建的应用 demo，后台数据库使用 MongoDB 和 MySQL，并使用 Redis 存储 session 和一些统计数据。

API列表

第一部分 【发送请求可用postman发送json格式数据】

该部分使用的数据库是 MongoDB 和 Redis。

在 static/test 目录下有如下的测试表单，除了用于测试外，也可看出具体的数据通讯协议：

• register.html
• login.html
• logout.html
• passwd.html
• uploads.html

说明：

• 输入数据通过 form 表单提交，返回数据均为 json。
• 使用 Beego 的 ParseForm 功能将输入数据解析到 struct 中。
• 使用 Beego 的 Validation 功能对数据进行校验。
• 使用 scrypt 算法进行密码处理。
• 对于数据库返回的错误，单独区分“记录不存在”和“记录重复”两种错误。
• 由于 Beego 本身不支持多文件上传，故单独实现了 uploads API 来展示该功能，该功能与数据库无关。

第二部分

该部分使用的数据库是 MySQL。

roles表结构如下：

初始建数据库表的脚本位于：scripts/sql/db.sql。

多记录 api，提供如下参数：

• query=col1:op1:val1,col2:op2:val2 ...
• order=col1:asc|desc,col2:asc|esc ...
• limit=n，缺省为 10
• offset=n，缺省为 0

query 的 op 值：

• eq，等于
• ne，不等于
• gt，大于
• ge，大于等于
• lt，小于
• le，小于等于

说明：

• 参考 RESTful 模式设计 API。
• 使用 JSON Web Token (JWT) 做认证手段。
• 输入数据采用 json，返回数据也是 json。
• 数据库操作使用原生 SQL，没有采用 ORM。
• 对可能的 NULL 值做了处理。
• 多记录查询通过拼接 SQL 语句实现，故对输入参数做了一些校验和处理。
• 同样单独区分“记录不存在”和“记录重复”两种数据库错误。

环境

GO语言

包括安装 go，设置 $GOPATH 等，具体可参考：How to Write Go Code。

MongoDB

在 conf/app.conf 中设置 MongoDB 参数，如：

[mongodb]
url = mongodb://root:root@47.111.77.29:27017/admin

完整的 url 写法可参考：http://godoc.org/gopkg.in/mgo.v2#Dial

这里单独封装了一个 mymongo 包来实现数据库的初始化，以简化后续的数据库操作。

MySQL

在 conf/app.conf 中设置 MySQL 参数，如：

[mysql]
url = root:root123@tcp(47.111.77.29:3306)/mysql?charset=utf8&parseTime=True&loc=Local

完整的 url 写法可参考：https://github.com/go-sql-driver/mysql#dsn-data-source-name

这里单独封装了一个 mymysql 包来实现数据库的初始化，以简化后续的数据库操作。

Redis

在 conf/app.conf 中设置 Redis 参数，涉及两个地方，一个是 session，一个是 cache，两者可以不同：

sessionproviderconfig = 47.111.77.29:6379

[cache]
server = 47.111.77.29:6379
password =

这里单独封装了一个 myredis 包来实现数据库的初始化，以简化后续的数据库操作。

运行

将代码放在 $GOPATH/src 目录下：

$ cd $GOPATH/src/
$ git clone https://github.com/Mountains-and-rivers/beego-mysql-redis-mongodb.git

从 go1.7 开始，使用 glide 工具来管理依赖包，需要事先安装好 glide 。

安装依赖包：

$ cd $GOPATH/src/beego-mysql-redis-mongodb/
$ glide install

如果不使用 glide ，也可手工安装依赖包，但可能会有包版本的兼容问题：

$ go get -u github.com/astaxie/beego
$ go get -u github.com/astaxie/beego/session/redis
$ go get -u gopkg.in/mgo.v2
$ go get -u github.com/garyburd/redigo/redis
$ go get -u github.com/go-sql-driver/mysql
$ go get -u golang.org/x/crypto/scrypt      ---  可手动git clone 到本地$GOPATH/src/golang.org/x 再执行
$ go get -u github.com/dgrijalva/jwt-go

安装 bee 工具，调试阶段很好用：

$ go get -u github.com/beego/bee

开始运行：

$ cd $GOPATH/srcbeego-mysql-redis-mongodb/
$ bee run

______
| ___ \
| |_/ /  ___   ___   
| ___ \ / _ \ / _ \  
| |_/ /|  __/|  __/  
\____/  \___| \___| v1.10.0
2019/06/08 18:35:44 WARN     ▶ 0001 Running application outside of GOPATH
2019/06/08 18:35:44 INFO     ▶ 0002 Using 'beego-mysql-redis-mongodb' as 'appname'
2019/06/08 18:35:44 INFO     ▶ 0003 Reload server listening at :12450
2019/06/08 18:35:44 INFO     ▶ 0004 Initializing watcher...
2019/06/08 18:35:45 SUCCESS  ▶ 0005 Built Successfully!
2019/06/08 18:35:45 INFO     ▶ 0006 Restarting 'beego-mysql-redis-mongodb.exe'...
2019/06/08 18:35:45 SUCCESS  ▶ 0007 './beego-mysql-redis-mongodb.exe' is running...
2019/06/08 18:35:45 2068 :8080

访问：http://localhost:8080/

当前版本：

$ bee version
______
| ___ \
| |_/ /  ___   ___
| ___ \ / _ \ / _ \
| |_/ /|  __/|  __/
\____/  \___| \___| v1.10.0

├── Beego     : 1.11.2
├── GoVersion : go1.12.5
├── GOOS      : windows
├── GOARCH    : amd64
├── NumCPU    : 6
├── GOPATH    : D:\go\place
├── GOROOT    : C:\Go\
├── Compiler  : gc
└── Date      : Saturday, 8 Jun 2019