这是我参与「第五届青训营 」笔记创作活动的第5天。
课程讲授内容
- 课程介绍,包括课程目标和 Hertz、Kitex 和 Gorm 三大框架的介绍;
- Go 框架三件套的使用;
- 项目实战,串联三件套
1 课程介绍
1.1 三件套介绍
- Grom:Gorm是一个已经迭代了10年+的功能强大的ORM框架,在字节内部被广泛使用并且拥有非常丰富的开源扩展。
- Kitex:Kitex 是字节内部的Golang微服务RPC框架,具有高性能、强可扩展的主要特点,支持多协议并且拥有丰富的开源扩展。
- Hertz:Hertz 是字节内部的HTTP框架,参考了其他开源框架的优势,结合字节跳动内部的需求,具有高易用性、高性能、高扩展性特点。
2 三件套的使用
2.1 Gorm 中文文档
- Gorm 的约定(默认) gorm.cn/zh_CN/docs/…
- Gorm使用名为 ID 的字段作为主键
- 使用结构体的蛇形负数作为表名
- 字段名的蛇形作为列名
- 使用CreatedAt、UpdatedAt字段作为创建、更新时间
- Gorm 支持的数据库 gorm.cn/zh_CN/docs/…
- GORM目前支持MySQL、SQLServer、PostgreSQL、SQLite
- GORM通过驱动来连接数据库,如果需要连接其它类型的数据库,可以复用/自行开发驱动。
- Gorm 创建数据 gorm.cn/zh_CN/docs/…
- 查询数据
- First的使用踩坑
- 使用 First 时,需要注意查询不到数据会返回ErrRecordNotFound。
- 使用 Find 查询多条数据,查询不到数据不会返回错误。
- 使用结构体作为查询条件
- 当使用结构作为条件查询时,GORM 只会查询非零值字段。这意味着如果您的字段值为0、false或其他零值,该字段不会被用于构建查询条件,使用 Map 来构建查询条件。即 map 会解决查询 0 值的问题。
- First的使用踩坑
- Gorm 更新数据
- 使用 Struct 更新时,只会更新非零值,如果需要更新零值可以使用 Map 更新或使用 Select 选择字段。
- Gorm 删除数据
- 物理删除 Delete
- 软删除
DeletedAt- 使用
Unscoped可以查询到被软删的数据
- 使用
- Gorm 事务
- 使用 Begin、Commit 和 Rollback 方法用于使用事务
- Gorm 提供了 Tansaction 方法用于自动提交事务,避免用户漏写 Commit、Rollbcak。
2.2 Kitex 中文文档
- 定义 IDL:如果我们要进行RPC,就需要知道对方的接口是什么,需要传什么参数,同时也需要知道返回值是什么样的。这时候,就需要通过IDL来约定双方的协议,就像在写代码的时候需要调用某个函数,我们需要知道函数签名一样。
- 生成代码命令:
kitex -module example -service example echo.thrift- 文件结构
-
build.sh: 构建脚本
-
kitex gen: lDL内容相关的生成代码,主要是基础的 Server/Client代码。
-
main.go:程序入口
-
handler.go:用户在该文件里实现IDL service定义的方法
-
- 文件结构
namespace go api
struct Request {
1: string message
}
struct Response {
1: string message
}
service Echo {
Response echo(1: Request req)
}
- kitex 注册与发现
2.3 Hertz 中文文档
- hertz 路由
- www.cloudwego.io/zh/docs/her…
- Hertz提供了GET、POST、PUT、DELETE、ANY等方法用于注册路由。
- Hertz提供了路由组(Group )的能力,用于支持路由分组的功能
- Hertz提供了参数路由和通配路由,路由的优先级为:静态路由>命名路由>通配路由
- hertz 中间件
- Hertz的中间件主要分为客户端中间件与服务端中间件
3 实战案例介绍
课程总结
收获:了解了 Go 框架的三件套:Gorm(ORM)、Kitex(RPC) 和 Hertz(HTTP),以及其基础使用,通过笔记项目实战了解了如何将三件套串联起来。
存在问题:课下还得将三件套的使用温习重复,理解笔记项目。