这是我参与「第五届青训营」伴学笔记创作活动的第6天。
Go框架三件套包括Gorm、Kitex和Hertz。Gorm是一个已经迭代了10年+的功能强大的ORM框架;Kitex是字节跳动内部的Golang微服务RPC框架,具有高性能、强可扩展的主要特点,支持多协议并且拥有丰富的开源扩展;Hertz是字节跳动内部的HTTP框架,具有高易用、高性能、高扩展性的特点。
一、Gorm
- Gorm的约定(默认):
Gorm使用名为ID的字段作为主键。
使用结构体的蛇形负数作为表名。
字段名的蛇形作为列名。
使用CreatedAt、UpdatedAt字段作为创建、更新时间。
- 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提供了
Begin、Commit、Rollback方法用于使用事务。
Gorm提供了Tansaction方法用于自动提交事务,避免用户漏写Commit、Rollback。
- 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… |
| 丰富的示例代码与业务Demo | github.com/cloudwego/k… |
三、Hertz
- Hertz基本使用
使用Hertz实现,服务器监听8080端口并注册了一个GET方法的路由函数。
- Hertz路由
Hertz提供了GET、POST、PUT、DELETE、ANY等方法用于注册路由。
Hertz提供了路由组的能力,用于支持路由分组的功能。
Hertz提供了参数路由和通配路由,路由的优先级为:静态路由>命名路由>通配路由。
- Hertz参数绑定
Hertz提供了
Bind、Validate、BindAndValidate函数用于进行参数绑定和校验。
- 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… |
| 丰富的示例代码与业务Demo | github.com/cloudwego/h… |