之前在学区块链,然后看到很多区块链项目都是基于golang在开发,包括以太坊的官方go-ethereum。了解了下go是google出品,很多人说其有c/c++的性能,然后却有脚本语言的开发效率。我就被吸引到了,开始学一下。方便后面搞后台遇到性能瓶颈的场景,以及区块链的开发。
加上最近小程序大热,这块技术栈也要学习了解下。我就想着动手做个简单的抽奖小程序,后台可以用go来实现,又能学习小程序开发,一箭双雕,开搞。动手实践永远是学习的最好方式。
一、后台整体架构
整体后台的结构设计就如上图:
小程序和后台间使用https通信,保证安全性,这也是为了满足小程序官方的硬性规定。腾讯负载均衡作为后台入口有几个好处:帮助处理https的流量,然后解密后再将请求通过http转发给后端的服务器,简化了逻辑,减少了https对后台服务的性能影响,同时还能配置进行动态的伸缩。
负载均衡将请求通过http转发给cvm进行处理。nginx做了个反向代理,go服务端跑在本地。
使用腾讯云的redis和mysql数据库。redis用于频繁的用户鉴权等,mysql保存常规数据。
这样的设计在抽奖这种情境下,已经能保证足够的并发和流量了。如果想提高并发量,可以通过配置负载均衡来进行动态伸缩,然后增加云数据库的处理能力。有时间再写下怎么进行性能评测和相应的提高并发量的升级。
二、抽奖流程设计
因为每天工作挺忙的,没那么多时间。就准备先弄最简单的抽奖逻辑,有时间和精力再迭代。用户可以进入小程序创建一个抽奖活动,设置活动主题、开奖时间、奖品和数量。然后就能分享出去,其它用户点击后参加抽奖。到达开奖时间后,则进行随机的开奖,每个参加抽奖的用户最多只能中奖1次。开奖后,对所有抽奖用户发送消息提醒。
其实可以简单地利用开奖来进行大致划分:
开奖前:用户创建抽奖活动后,所有用户都能参加抽奖、取消抽奖,创建者能删除抽奖活动。
开奖中:到达开奖时间,锁定这个抽奖活动,不允许用户操作了。然后内部进行抽奖,将奖品随机分给抽奖用户。
开奖后:奖品分配完毕,结果公布。向所有用户展示开奖结果,需要通知到参加抽奖的用户。
三、api文档设计
接口文档非常重要,值得用心好好写,我觉得这是做后台开发的基本素养。不管项目小还是大,一份良好的文档是必需的。文档写好了,可以有很多好处。随着时间和迭代,我们依然能对每个接口有很好的了解。接口文档可以将后台开发同外部依赖脱离开,使得前端和后台能解耦。同时,写接口文档的过程其实就是思考和梳理的过程,通过细致地讨论和思考,理清楚一些细节和避开一些坑。
下面是我维护的文档,先是基本的描述,域名、基路径等。
然后就是每个接口的详细描述,要定义好请求和返回的结构,以及每个参数的含义和格式。
我一般会在git上维护一份最新的md格式接口文档。如果有协作的话,其他人对接口有疑问,不用在沟通上每次扯皮,按照文档的说明来调用即可。
四、实现
4.1 web框架选择
调研了下go的web框架,目前用得较多的是beego、echo、gin,所以随便选个就行。我选了echo,感觉文档稍微全一些。但相对于其他语言的web框架,echo的文档太少、不全,学习和使用成本高些。
使用echo,我先整体过了一遍官方文档,最好最全的资料还是官方文档介绍,所以英文要始终坚持学习。附上网址:https://echo.labstack.com/guide
这里主要的流程基本差不多,注册url处理函数,然后就是crud操作,及各种内部逻辑了。 每个请求附带了内部自定义的session_id,在echo的Middleware中进行验证。
4.2 数据库操作
4.2.1 mysql
我用到的是Go-MySQL-Driver这个包,github地址:https://github.com/go-sql-driver/mysql
如何crud的话,我看了遍使用文档,地址:http://go-database-sql.org/
连接db
import "database/sql" import _ "github.com/go-sql-driver/mysql" db, err = sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/lottery?charset=utf8")
获取数据
利用Query()绑定参数,进行查询。这里比较麻烦的是获取db里的一行数据,需要用Scan()逐个赋值。当取出来数据很多的时候还是有点麻烦的,不过我还是蛮喜欢自己操控sql语句的,一些orm框架用起来很简单,但对编程思维和写sql的训练不够。自己写sql,就会考虑怎么优化。我会经常多问自己一些问题:能不能少进行一次sql查询?查询的sql语句能不能更高效?设计的sql表能不能更优?
var (
id int
name string
)rows, err := db.Query("select id, name from users where id = ?", 1) if err != nil {
log.Fatal(err)}defer rows.Close() for rows.Next() {
err := rows.Scan(&id, &name)
if err != nil {
log.Fatal(err)
}
log.Println(id, name) }err = rows.Err() if err != nil {
log.Fatal(err)}
更新数据
_, err = db.Exec("update events set status = ?,cancel_time=? where id = ? and status=?", util.DBEventStatusCANCELED, time.Now().Unix(), queryEvent.ID, util.DBEventStatusINIT)
上面是我将抽奖活动从初始状态,设置为取消状态的sql语句, 使用db.Exec来执行更新、删除等语句。
事务
事务的话,可以具体看文档:
tx, err := db.Begin() if err != nil {
log.Fatal(err)}defer tx.Rollback() stmt, err := tx.Prepare("INSERT INTO foo VALUES (?)") if err != nil {
log.Fatal(err)}defer stmt.Close() for i := 0; i < 10; i++ {
_, err = stmt.Exec(i)
if err != nil {
log.Fatal(err)
} }err = tx.Commit() if err != nil {
log.Fatal(err)}
4.2.2 redis
每个请求都需要进行鉴权session,这里使用的是redis。redis操作用的 github.com/garyburd/redigo/redis这个库。
大家的流程都差不多:连接redis,然后进行put、get操作。这里有个简单封装的例子,可以借鉴。https://github.com/aiscrm/redisgo/blob/master/redis.go
4.3 微信登录流程
这里可以说一下微信用户使用小程序,如何进行登录的流程。
a.用户进入小程序。小程序使用wx.login()去微信后台进行登录,登录成功会获得一个code。真实的返回是这样的:
{errMsg: "login:ok", code: "001nnSQv1QStGa0X1bSv13u7Rv1nnSQA”}
b.小程序将这个code发送我给我们自己的后台。
c.后台收到这个code后,拼接一个url去微信后台获取该微信用户的session_key。
https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code
各字段的含义:
appid:这里填小程序 appId
secret:小程序 appSecret
js_code:小程序发来的 code
grant_type:授权类型,此处只需填写 authorization_code
捞了条日志看下微信返回的数据。其中session_key,对应该用户的会话密钥;expires_in,凭证有效时间,单位:秒;openid,用户唯一标识。
{"time":"2018-10-13T18:19:41.472758451+08:00","level":"DEBUG","prefix":"echo","file":"auth.go","line":"52","message":"result:map[session_key:ig6tsRoILO2cpxCnk0TXVg== expires_in:7200 openid:(隐私删除)]”}
d.自己后台定义登录态,返回给小程序自定义登录态。这个时候用户相当于成功登录了,那么我们给这个用户一个我们自己定义的session_id,然后每个请求都需要携带此session_id,用于验证。
4.4 抽奖活动状态机设计
其实整个后台的业务逻辑重点是跟随抽奖活动的状态来变换的。所以每个发起的抽奖,我定义了几个状态,状态机如下:
//数据库中抽奖活动的状态常量,const (
DBEventStatusINIT = 0 //抽奖中,活动创建后此状态,允许参加抽奖
DBEventStatusOPENING = 1 //开奖中,不允许抽奖了
DBEventStatusOPEND = 2 //已经开奖了,
DBEventStatusCANCELED = 9 //活动取消 )
活动创建成功即为状态0,可以进行抽奖。
创建者在开奖前可以取消,活动由0可转变为状态9,不可再抽奖,终态。
状态0的活动开奖前1分钟,会进入开奖阶段,转换为状态1,这时候不可抽奖。
抽奖完成后,状态为1的活动会转换为状态2,终态,进行通知结果等处理。
五、总结
做完这个蛮辛苦的,要学很多东西,看很多文档。比如小程序的官方文档需要看,不然登录等等后台没法配合。使用的语言是go,不是很熟悉,边学边干,echo框架的文档也要看。然后设计抽奖的整个流程,设计数据库,设计接口请求和返回格式,编写接口文档。由于大块的时间不多,打断后再接上效率很低。不过整个弄完,感觉对go和小程序有了一个比较全面的理解,接下来我还会继续搞。
然后如何用docker来快速部署?如何打造完整的自动化编译、部署、测试的流程?这些后面有时间,我会后面继续总结发。
推荐阅读:
关注云加社区,回复 3 加读者群
点击阅读原文,获取更多技术干货!
给腾小云点赞,代码无bug