GO框架三件套|青训营笔记

101 阅读4分钟

这是我参与「第五届青训营」伴学笔记创作活动的第6天。
Go框架三件套包括Gorm、Kitex和Hertz。Gorm是一个已经迭代了10年+的功能强大的ORM框架;Kitex是字节跳动内部的Golang微服务RPC框架,具有高性能、强可扩展的主要特点,支持多协议并且拥有丰富的开源扩展;Hertz是字节跳动内部的HTTP框架,具有高易用、高性能、高扩展性的特点。

一、Gorm

  • Gorm的约定(默认):

Gorm使用名为ID的字段作为主键。
使用结构体的蛇形负数作为表名。
字段名的蛇形作为列名。
使用CreatedAtUpdatedAt字段作为创建、更新时间。

  • Gorm支持的数据库:

GORM目前支持MySQL、SQLServer、PostgreSQL、SQLite。
GORM通过驱动来连接数据库,如果需要连接其他类型的数据库,可以复用/自行开发驱动。

  • Gorm创建数据

使用clause.OnConflict处理数据冲突。
通过使用default标签为字段定义默认值。

  • Gorm查询数据

使用First时,需要注意查询不到数据会返回ErrRecordNotFound。使用Find查询多条数据,查询不到数据不会返回错误。
当使用结构作为条件查询时,GORM指挥查询非零值字段,意味着如果字段为0、"、false或其他零值,该字段不会被用于构建查询条件,使用Map来构建查询条件。

  • Gorm更新数据

使用Struct更新时,只会更新非零值,如果需要更新零值可以使用Map更新或使用Select选择字段。

  • Gorm删除数据

GORM提供了gorm.DelectedAt用于帮助用户实现软删除。
拥有软删除能力的Model调用Delete时,记录不会被从数据库中真正删除。但GORM会将DelectedAt置为当前时间,并且不能再通过正常的查询方法找到该记录。
使用Unscoped可以查询到被软删除的数据。

  • Gorm事务

Gorm提供了BeginCommitRollback方法用于使用事务。
Gorm提供了Tansaction方法用于自动提交事务,避免用户漏写CommitRollback

  • GORM Hook

GORM在提供了CURD的Hook能力。
Hook是在创建、查询、更新、删除等操作之前、之后自动调用的函数。
如果任何Hook返回错误,GORM将停止后续的操作并回滚事务。

  • Gorm性能提高

对于写操作,为了确保数据的完整性,GORM会将它们封装在事务内运行。但这会降低性能,可以使用SkipDefaultTransaction关闭默认事务。
使用PrepareStmt缓存预编译语句可以提高后续调用的速度。

  • Gorm生态
用法文档链接
GORM代码生成工具github.com/go-gorm/gen
GORM分片库方案github.com/go-gorm/sha…
GORM手动索引github.com/go-gorm/hin…
GORM乐观锁github.com/go-gorm/opt…
GORM读写分离github.com/go-gorm/dbr…
GORM OpenTelemetry扩展github.com/go-gorm/ope…

二、Kitex

  • 定义IDL

使用IDL定义服务与接口
如果要进行RPC,就需要知道对方的接口是什么,需要传什么参数,同时也需要知道返回值是什么样的。就需要通过IDL来约定双方的协议。

  • Kitex生成代码

使用kitex -module example -service example echo.thrift命令生成代码
build.sh:构建脚本
kitex_gen:IDL内容相关的生成代码
main.go:程序入口
handler.go:用户在该文件里实现IDL service定义的方法

  • Kitex服务注册与发现

Kitex服务注册与发现已经对接了服务注册与发现中心,如ETCD、Nacos等。

  • Kitex生态
用法文档链接
XDS扩展github.com/kitex-contr…
opentelemetry扩展github.com/kitex-contr…
ETCD服务注册与发现扩展github.com/kitex-contr…
Nacos服务注册与发现扩展github.com/kitex-contr…
Zookeeper服务注册与发现扩展github.com/kitex-contr…
polaris扩展github.com/kitex-contr…
丰富的示例代码与业务Demogithub.com/cloudwego/k…

三、Hertz

  • Hertz基本使用

使用Hertz实现,服务器监听8080端口并注册了一个GET方法的路由函数。

  • Hertz路由

Hertz提供了GET、POST、PUT、DELETE、ANY等方法用于注册路由。
Hertz提供了路由组的能力,用于支持路由分组的功能。
Hertz提供了参数路由和通配路由,路由的优先级为:静态路由>命名路由>通配路由。

  • Hertz参数绑定

Hertz提供了BindValidateBindAndValidate函数用于进行参数绑定和校验。

  • Hertz中间件

Hertz的中间件主要分为客户端中间件与服务端中间件。

  • Hertz Client

Hertz提供了HTTP Client用于帮助用户发送HTTP请求。

  • Hertz代码生成工具

Hertz提供了代码生成工具Hz,通过定义IDL文件可生成对应的基础服务代码。

  • Hertz生态
用法文档链接
HTTP2扩展github.com/hertz-contr…
opentelemetry扩展github.com/hertz-contr…
国际化扩展github.com/hertz-contr…
反向代理扩展github.com/hertz-contr…
JWT鉴权扩展github.com/hertz-contr…
Websocket扩展github.com/hertz-contr…
丰富的示例代码与业务Demogithub.com/cloudwego/h…