初入GO框架三件套|青训营笔记
这是我参与「第五届青训营」伴学笔记创作活动的第 8天
在后面会依次倒叙回顾之前的学习课程,便于复习~
一、课程重点内容
- 三件套的介绍
- 三件套的基本用法
- 实战案例介绍
下面是对课程重点内容的思考与总结,有问题或者错误,可以批评指正呐~
二、三件套介绍
| Gorm | Kitex | Hertz |
|---|---|---|
| 一个已经迭代了10年+的 功能强大的ORM框架,在字节内 部被广泛使用并且拥有非常丰富的开源扩展。 | Golang 微务RPC框架,具有 高性能、强可扩展的主要特点,支持多协议并且 拥有丰富的开源扩展。 | 字节内部的 HTTP框架, 参考了其他开源框架的优势,结合 字节跳动内部的需求,具有高易用 性、高性能、高扩展性特点。 |
三、三件套的使用
-
Gorm的基本使用
- 基本使用:
-
Gorm的踩坑
-
Gorm使用名为ID的字段作为主键
-
使用结构体的蛇形负数作为表名
-
字段名的蛇形作为列名
-
使用CreatedAt、UpdatedAt字段作为创建、更新时间
-
使用 First时,需要注意查询不到数据会返ErrRecordNotFound. 使用Find查询多条数据,查询不到数据不会返回错误。
-
当使用结构作为条件查询时,GORM 只会查询非零值字段。这意味着如果您的字段值为0、"、false或其他零值,该字段不会被用于构建查询条件,使用 Map来构建查询条件。
-
GORM提供了 gorm.DeletedAt用于帮用户实现软删,拥有软删除能力的Model调用 Delete时,记录不会被从数据库中真正删除。但GORM会将 DeletedAt置为当前时间,并且你不能再通过正常的查询方法找到该记录。使用Unscoped可以查询到被软删的数据。
- 凡是有利必有弊,在具体的场合中使用此字段时,默认会被赋予索引的条件,这就导致,唯一索引的失效,为了解决此问题推荐使用soft_delete
-
-
Kitex的基本使用
Kitex目前对 Windows 的支持不完善,目前我用的是Windows,于是只能采用WSL2开发,注意千万不能是WSL1,会有各种奇怪的bug。
-
定义IDL
-
什么是IDL?如果我们要进行RPC,就需要知道对方的接口是什么,需要传什么参数,同时也需要知道返回值是什么样的。这时候,就需要通过IDL来约定双方的协议,就像在写代码的时候需要调用某个函数,我们需要知道函数签名一样。
-
-
生成代码
使用 kitex -module example -service example echo.thrift命令生成代码build.sh :构建脚本 kitex gen :IDL内容相关的生成代码,主要是基础的Server/Client代码。 main.go程序口 handler.go用在该文件里实现 IDLservice 定义的方法
-
-
Hertz的基本使用
-
路由:
- Hertz 提供了 GET、POST、PUT、DELETE、ANY等方法用于注册路由,
- 同时提供了路由组(Group)的能力,用于支持路由分组的功能
- 也提供了参数路由和通配路由,路由的优先级为:静态路由>命名路由>通配路由
-
参数绑定:Hertz提供了 Bind、 Validate、 BindAndValidate 函数用于进行参数绑定和校验
-
中间件:Hertz的中间件主要分为客户端中间件与服务端中间件,如下展示一个服务端中间件。
-
四、实战案例介绍
笔记项目是一个使用Hertz、Kitex、Gorm搭建出来的具备一定业务逻辑的后端API项目。
| 服务名称 | 服务介绍 | 传输协议 | 主要技术栈 |
|---|---|---|---|
| demoapi | API服务 | HTTP | Kitex/Hertz |
| demouser | 用户数据管理 | Protobuf | Gorm/Kitex |
| demonote | 笔记数据管理 | Thrift | Gorm/Kitex |
五、课程总结
- 了解Gorm/Kitex/Hertz是什么
- 熟悉Gorm/Kitex/Hertz的基础用法
- 通过实战案例分析将三个框架的使用串联了起来