【Go WEB进阶实战】开源的电商前后台API系统_用go开发大型电商业务系统
建议大家使用分组路由进行路由的管理,能让我们的路由管理更加的清晰规范。能保证随着项目的迭代也能在指定的路由组中进行管理,明确接口边界。Login()//商品})//以下是需要登录的//文章group.POST(“list/”, article.Article.List)//全部文章列表group.POST(“my/list/”, article.Article.MyList) //我的文章列表。
先自我介绍一下,小编浙江大学毕业,去过华为、字节跳动等大厂,目前阿里P7
深知大多数程序员,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年最新Golang全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上Go语言开发知识点,真正体系化!
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新
如果你需要这些资料,可以添加V获取:vip1024b (备注go)
正文
define.go简化示例
package frontendLogin
type RegisterReq struct {
Name string json:"name" v:"required#用户名必传"
PassWord string json:"password" v:"required-if:type,0|password#password必须传递|密码限定在6-18位之间"
Avatar string json:"avatar"
Sex int json:"sex"
Sign string json:"sign"
SecretAnswer string json:"secret\_answer"
UserSalt string json:"user\_salt,omitempty"
}
type AccessTokenRes struct {
AccessToken string json:"access\_token"
//获取到的凭证
ExpiresIn int json:"expires\_in"
//凭证有效时间,单位:秒
}
.
.
.
service.go简化示例
package frontendLogin
import (
“context”
.
.
.
)
var service = frontendLoginService{}
type frontendLoginService struct {
}
.
.
.
//注册
func (s *frontendLoginService) Register(ctx context.Context, req *RegisterReq) (err error) {
//查询用户名是否存在
count, err := dao.UserInfo.Ctx(ctx).Where(“name”, req.Name).Count()
if err != nil || count > 0 {
return gerror.New(“用户名已存在,请换个用户名注册账号吧”)
}
UserSalt := grand.S(10)
req.PassWord = library.EncryptPassword(req.PassWord, UserSalt)
req.UserSalt = UserSalt
//添加新用户
_, err = dao.UserInfo.Ctx(ctx).Insert(req)
if err != nil {
return err
}
return
}
.
.
.
api.go简化示例
package frontendLogin
import (
“github.com/goflyfox/gtoken/gtoken”
.
.
.
)
var FrontendLogin = new(frontendLogin)
type frontendLogin struct {
}
//注册
func (s *frontendLogin) Register(r *ghttp.Request) {
var data *RegisterReq
if err := r.Parse(&data); err != nil {
response.ParamErr(r, err)
}
err := service.Register(r.Context(), data)
if err != nil {
response.JsonExit(r, 0, “注册失败”)
} else {
response.SuccessWithData(r, nil)
}
}
.
.
.
好了,到这里我们就完成了gtoken的集成,并且自己编写了中间件,编写了服务。
对Gtoken实现原理感兴趣的小伙伴可以阅读这篇文章:# 通过阅读源码解决项目难题:GToken替换JWT实现SSO单点登录
下面再带大家重点看一下前面提到的路由文件:
4.定义路由组,明确接口边界
建议大家使用分组路由进行路由的管理,能让我们的路由管理更加的清晰规范。
我们根据业务逻辑拆分路由组,比如下面代码中的商品管理,文章管理,点赞管理就很清晰。
能保证随着项目的迭代也能在指定的路由组中进行管理,明确接口边界。
func Init(s *ghttp.Server) {
Login()
s.Group(“/frontend/”, func(group *ghttp.RouterGroup) {
//商品
group.Group(“goods/”, func(group *ghttp.RouterGroup) {
group.POST(“list/”, goods.Goods.List)
group.POST(“detail/”, goods.Goods.Detail)
group.POST(“category/”, goods.Goods.Category)
})
//以下是需要登录的
group.Middleware(middleware.MiddlewareGToken.GetToken)
//文章
group.Group(“article/”, func(group *ghttp.RouterGroup) {
group.POST(“add/”, article.Article.Add)
group.POST(“update/”, article.Article.Update)
group.POST(“delete/”, article.Article.Delete)
group.POST(“list/”, article.Article.List) //全部文章列表
group.POST(“my/list/”, article.Article.MyList) //我的文章列表
group.POST(“detail/”, article.Article.Detail) //文章详情
})
//点赞
group.Group(“praise/”, func(group *ghttp.RouterGroup) {
group.POST(“add/”, praise.Praise.Add)
group.POST(“delete/”, praise.Praise.Delete)
group.POST(“list/”, praise.Praise.List)
})
})
}
注意:我并没有严格按照RESTful Api的规范设计接口,而是全部使用的POST请求。
这里并没有严格限制,使用什么API接口规范和框架、开发语言都没有关系,适合自己的就是最好的。
5. 上传图片到云平台
我们以上传图片到七牛云举例:
- 首先我们使用goframe提供的r.GetUploadFiles(“file”) 上传文件到本地(如果部署到服务器,就是服务器的本地)
- 按照云平台提示,配置相关的AKSK
- 将本地文件地址上传到云平台
- 删除本地文件
下面的关键代码已加注释,AKSK等配置信息在 /config/config.toml 文件中配置
package upload
var Upload = uploadApi{}
type uploadApi struct{}
// Upload uploads files to /tmp .
func (*uploadApi) Img(r *ghttp.Request) {
files := r.GetUploadFiles(“file”)
dirPath := “/tmp/”
names, err := files.Save(dirPath, true)
if err != nil {
r.Response.WriteExit(err)
}
for _, name := range names {
localFile := dirPath + name
bucket := g.Cfg().GetString(“qiniu.bucket”)
key := name
accessKey := g.Cfg().GetString(“qiniu.accessKey”)
secretKey := g.Cfg().GetString(“qiniu.secretKey”)
putPolicy := storage.PutPolicy{
Scope: bucket,
}
mac := qbox.NewMac(accessKey, secretKey)
upToken := putPolicy.UploadToken(mac)
cfg := storage.Config{}
// 空间对应的机房
cfg.Zone = &storage.ZoneHuabei
// 是否使用https域名
cfg.UseHTTPS = true
// 上传是否使用CDN上传加速
cfg.UseCdnDomains = false
// 构建表单上传的对象
formUploader := storage.NewFormUploader(&cfg)
ret := storage.PutRet{}
// 可选配置
putExtra := storage.PutExtra{
Params: map[string]string{},
}
err = formUploader.PutFile(r.GetCtx(), &ret, upToken, key, localFile, &putExtra)
if err != nil {
response.FailureWithData(r, 0, err, “”)
}
fmt.Println(ret.Key, ret.Hash)
//删除本地文件
err = os.Remove(localFile)
if err != nil {
g.Dump(“删除本地文件失败:”, err)
}
fmt.Println(“删除本地文件成功”, localFile)
//返回数据
response.SuccessWithData(r, g.Map{
“url”: g.Cfg().GetString(“qiniu.url”) + ret.Key,
})
}
}
6.如何科学的写搜索?
我来说明一个经典的搜索场景:
我们有多个搜索条件,这些搜索条件非必传,传了哪些条件就命中哪些条件,如何实现比较科学呢?
我的建议是使用map支持set方法的特点,灵活的设置查询条件,避免在声明的时候赋值,那么实现需要做复杂的判断逻辑。
将查询条件封装为packListCondition方法,统一管理,方便多处复用。
func (s *goodsService) List(ctx context.Context, req *PageListReq) (res ListGoodsRes, err error) {
//实例化map
whereCondition := gmap.New()
//很好的理解了map是引用类型的特点 在这个函数中为查询条件赋值
packListCondition(req, whereCondition)
//map是引用类型,在packListCondition函数中已经做了赋值操作,不需要在接收返回值
count, err := dao.GoodsInfo.Ctx(ctx).Where(whereCondition).Count()
if err != nil {
return
}
res.Count = count
err = dao.GoodsInfo.Ctx(ctx).Where(whereCondition).OrderDesc(“id”).Page(req.Page, req.Limit).Scan(&res.List)
if err != nil {
return
}
return
}
func packListCondition(req *PageListReq, whereCondition *gmap.Map) {
//使用map支持set的特性 避免在声明的时候赋值,那么写需要做的判断太复杂了。
if req.Keyword != “” {
whereCondition.Set(dao.GoodsInfo.Columns.DetailInfo+" like “, “%”+req.Keyword+”%“)
}
if req.Name != “” {
whereCondition.Set(dao.GoodsInfo.Columns.Name+” like “, “%”+req.Name+”%“)
}
if req.Brand != “” {
whereCondition.Set(dao.GoodsInfo.Columns.Brand+” like “, “%”+req.Brand+”%")
}
}
7.提供2套API接口
我们再来看一下目录结构,有个整体的认识:
- app/system 目录是我为了在一个项目中,同时开发前后台系统,提高代码复用率而创建的。
- 除了app/system 目录,其他目录都是通过goframe的 gf工具生成出来的。
- 所以实现一个项目提供2套API接口的核心是:如何在一个项目中启动两个服务,同时提供前后台项目的所需的接口API?
我是这么做的:
在我们main.go的入口文件中分别初始化前后台项目的路由文件,启动服务。
package main
import (
“github.com/gogf/gf/frame/g”
“shop/app/middleware”
“shop/app/system/backend”
“shop/app/system/frontend”
_ “shop/boot”
_ “shop/router”
)
func main() {
s := g.Server()
s.Use(middleware.Cors.CORS)
//后台项目
backend.Init(s)
//前端项目
frontend.Init(s)
s.Run()
}
底层思路是:前后台项目的路由基于路由组区分是哪个平台的接口。接口的内部逻辑,如果可以复用就复用;如果不能复用,是独立的功能就分别在system下的backend或者frontend下开发。
前台接口路由文件
func Init(s *ghttp.Server) {
s.Group(“/frontend/”, func(group *ghttp.RouterGroup) {
.
.
.
}
}
后台接口路由文件
func Init(s *ghttp.Server) {
s.Group(“/backend/”, func(group *ghttp.RouterGroup) {
.
.
.
}
}
小提示: 如果你的需求只是开发一个项目,那么就可以把system目录砍掉,直接在原生目录下开发就可以了。
到这里,我们就完成了项目的整体搭建和开发,感兴趣的小伙伴可以star、fork我开源到GitHub的项目源码:GitHub基于GoFrame搭建的电商前后台系统API
8.自动编译
自动编译是GoFrame集成好的功能,我们不需要去安装air自动编译插件,只需要使用如下命令就可以实现自动编译了:
gf run main.go
效果如下:
最后我们通过编写shell脚本,实现项目的一键部署到远程服务器:
9.一键部署脚本
RED_COLOR=‘\E[1;31m’ #红
GREEN_COLOR=‘\E[1;32m’ #绿
YELOW_COLOR=‘\E[1;33m’ #黄
BLUE_COLOR=‘\E[1;34m’ #蓝
PINK=‘\E[1;35m’ #粉红
RES=‘\E[0m’
echo -e “KaTeX parse error: Undefined control sequence: \* at position 15: {GREEN\_COLOR}\̲*̲\*\*\*基于GoFrame…{RES}\n\n”
echo -e “
Y
E
L
O
W
_
C
O
L
O
R
−
−
−
s
t
e
p
1
:
合并代码
−
−
−
{YELOW\_COLOR}---step1:合并代码---
YELOW_COLOR−−−step1:合并代码−−−{RES}”
git pull origin master
echo -e “${BLUE_COLOR}合并代码成功 ${RES}\n”
echo -e “
Y
E
L
O
W
_
C
O
L
O
R
−
−
−
s
t
e
p
2
:
编译
−
−
−
{YELOW\_COLOR}---step2:编译---
YELOW_COLOR−−−step2:编译−−−{RES}”
go build
echo -e “${BLUE_COLOR}编译完成 ${RES}\n”
echo -e “
Y
E
L
O
W
_
C
O
L
O
R
−
−
−
s
t
e
p
3
:
更改权限
−
−
−
{YELOW\_COLOR}---step3:更改权限---
YELOW_COLOR−−−step3:更改权限−−−{RES}”
chmod -R 777 shop
echo -e “${BLUE_COLOR}更改权限完成 ${RES}\n”
echo -e “
Y
E
L
O
W
_
C
O
L
O
R
−
−
−
s
t
e
p
4
:
杀掉进程并且运行
−
−
−
{YELOW\_COLOR}---step4:杀掉进程并且运行---
YELOW_COLOR−−−step4:杀掉进程并且运行−−−{RES}”
i1=$(ps -ef | grep -E “shop” | grep -v grep | awk '{print KaTeX parse error: Expected 'EOF', got '}' at position 2: 2}̲') echo -e "{BLUE_COLOR}杀掉进程
i
1
i1
i1{RES}\n"
kill -9 KaTeX parse error: Expected 'EOF', got '&' at position 4: i1 &̲& nohup ./shop …(ps -ef | grep -E “shop” | grep -v grep | awk '{print KaTeX parse error: Expected 'EOF', got '}' at position 2: 2}̲') echo -e "{GREEN_COLOR}****部署成功,部署的进程ID为:
i
2
i2
i2{RES}****"
学习资料
下面是建议大家动手实践的学习资料:
GoFrame学习专栏
GoFrame官方文档
总结
通过这篇文章我们基于GoFrame框架搭建了一个电商系统的前后台API,实践了如何集成gtoken实现登录,如何自定义中间件和服务,如何定义路由组,如何上传文件到云平台,以及在开发的过程中如何实现自动编译,当项目开发完毕,如何一键部署到远程服务器。
欢迎大家动手实践,欢迎在评论区探讨。
关于版本
这期内容介绍的是基于GoFramev1.16版本开源的项目:https://github.com/wangzhongyang007/goframe-shop/
目前GoFrame的最新版本是v2.4,我也基于最新版本开源了电商实战项目:https://github.com/wangzhongyang007/goframe-shop-v2
欢迎大家star这两个开源项目,也欢迎大家给我提优化建议。
最后
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
需要这份系统化的资料的朋友,可以添加V获取:vip1024b (备注Go)
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
这期内容介绍的是基于GoFramev1.16版本开源的项目:https://github.com/wangzhongyang007/goframe-shop/
目前GoFrame的最新版本是v2.4,我也基于最新版本开源了电商实战项目:https://github.com/wangzhongyang007/goframe-shop-v2
欢迎大家star这两个开源项目,也欢迎大家给我提优化建议。
最后
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
需要这份系统化的资料的朋友,可以添加V获取:vip1024b (备注Go)
[外链图片转存中…(img-FwEIIJhT-1713174920471)]
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
更多推荐
所有评论(0)