Go 框架三件套(Web/RPC/ORM) | 青训营笔记

146 阅读3分钟

这是我参与「第五届青训营 」笔记创作活动的第5天。

课程讲授内容

  1. 课程介绍,包括课程目标和 Hertz、Kitex 和 Gorm 三大框架的介绍;
  2. Go 框架三件套的使用;
  3. 项目实战,串联三件套

1 课程介绍

1.1 三件套介绍

  1. Grom:Gorm是一个已经迭代了10年+的功能强大的ORM框架,在字节内部被广泛使用并且拥有非常丰富的开源扩展。
  2. Kitex:Kitex 是字节内部的Golang微服务RPC框架,具有高性能、强可扩展的主要特点,支持多协议并且拥有丰富的开源扩展。
  3. 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 值的问题。
  • 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)
}

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),以及其基础使用,通过笔记项目实战了解了如何将三件套串联起来。

存在问题:课下还得将三件套的使用温习重复,理解笔记项目。