GO 框架三件套的介绍与使用(Web/RPC/ORM)| 青训营

121 阅读6分钟

一、介绍

01.Gorm

Gorm是一个已经迭代了10年+的功能强大的ORM框架,在字节内部被广泛使用并且拥有非常丰富的开源扩展。

02.Kitex

Kitex是字节内部的Golang微服务RPC框架,具有高性能、强可扩展的主要特点,支持多协议并且拥有丰富的开源展。

03.Hertz

Hertz是字节内部的HTTP框架,参考了其他开源框架的优势,结合字节跳动内部的需求,具有高易用性、高性能、高扩展性特点。

二、使用

1.Gorm的使用

约定

type Product struct {
Code string
Price uint
}
//定义gorm model
func (p Product) TableName() string {
return "product"
}//为model定义表名
func main() {
db,err := gorm.0pen(
mysql.0pen( dsn: "user:pass@tcp(127.0.0.1: 3306)/ dbname ?charset=utf8mb4&parseTime=True&loc=LocaL") ,&gorm. Config{})
if err!=nil{

panic( V: "failed to connect database")//连接数据库
//Create//创建数据
db.Create (&Product{Code: "D42", Price: 100})
//Read
var product Product
查询数据
db.First (&product,cond.... 1)
//根据整形主键查找
db.First (&product,conds... "code = ?""D42") //查找code 字段值为D42的记求
//Update 一将product 的price 更新为200
//更新数据
db.Model(&product) .Update( column: "Price",value: 200)
db.Modet (&product) . Updates(Product{Price: 200, Code: "F42"})
db.Model(&product) .Updates (map[string]interface{}{"Price": 200"Code": "F42"})//删除数据
//Delete 删除product
db. Delete (&product,conds... 1)

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

GORM支持的数据库

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

GORM创建数据

如何使用Upsert?

使用clause.OnConflict处理数据冲突

如何使用默认值?

通过使用default标签为字段定义默认值

GORM查询数据

First的使用踩坑

  • 使用First 时,需要注意查询不到数据会返回ErrRecordNotFound。
  • 使用Find查询多条数据,查询不到数据不会返回错误。

使用结构体作为查询条件

当使用结构作为条件查询时,GORM只会查询非零值字段。这意味着如果您的字段值为0、"、false或其他零值,该字段不会被用于构建查询条件,使用Map来构建查询条件。

Gorm更新数据

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

GORM删除数据

物理删除

软删除

  • GORM提供了gorm.DeletedAt用于帮助用户实现软删

  • 拥有软删除能力的Model调用Delete时,记录不会被 从数据库中真正删除。但GORM会将DeletedAt置为当 前时间,并且你不能再通过正常的查询方法找到该记录。

  • 使用Unscoped可以查询到被软删的数据

GORM事务

  • Gorm提供了Begin、Commit、 Rollback 方法用于使用事务
  • Gorm提供了Tansaction方法用于自动提交事务,避免用户漏写Commit、Rollbcak.

GORM Hook

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

GORM性能提高

  • 对于写操作(创建、更新、删除),为了确保数据的完整性,GORM 会将它们封装在事务内运行。但这会降低性能,你可以使用SkipDefaultTransaction关闭默认事务。
  • 使用PrepareStmt缓存预编译语句可以提高后续调用的速度,本机测试提高大约35 %左右。

GORM生态

GORM拥有非常丰富的扩展生态,以下列举一部分常用扩展。

关于更多的GORM用法可以查看Gorm的文档(gorm.cn)。

2.Kitex的使用

Kitex目前对Windows的支持不完善,如果本地开发环境是Windows的同学建议使用虚拟机或WSL2。

定义IDL

  • 使用IDL定义服务与接口 如果我们要进行RPC,就需要知道对方的接口是什么,需要传什么参数,同时也需要知道返回值是什么样的。这时候就需要通过IDL来约定双方的协议,就像在写代码的时候需要调用某个函数,我们需要知道函数签名一样。
  • Thrift: thrift.apache.org/docs/idl
  • Proto3 :developers.google.com/protocol-bu…

Kitex生成代码

  • 使用kitex -module example -service example echo.thrift命令生成代码
  • build.sh :构建脚本
  • kitex gen :IDL内容相关的生成代码,
  • 主要是基础的Server/Client代码。
  • main.go程序入口
  • handler.go用户在该文件里实现IDL service定义的方法

Kitex基本使用

  • 服务默认监听8888端口

Kitex Client发起请求

  • 创建Client
  • 发起请求

Kitex服务注册与发现

  • 目前Kitex的服务注册与发现已经对接了主流了服务注册与发现中心,如ETCD,Nacos等。

Kitex生态

Kitex拥有非常丰富的扩展生态,以下列举一部分常用扩展。

3.Hertz的使用

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

Hertz路由

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

Hertz参数绑定

  • Hertz提供了Bind、 Validate、 BindAndValidate 函数用于进行参数绑定和校验

Hertz中间件

  • Hertz的中间件主要分为客户端中间件与服务端中间件,如下展示一个服务端中间件。

如何终止中间件调用链的执行?

  • c.Abort
  • c.AbortWithMsg
  • c.AbortWlthStats

Hertz Client

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

Hertz代码生成工具

Hertz提供了代码生成T具Hz,通过定义IDL(inteface description language )文件即可生成对应的基础服务代码。

Hertz代码生成工具

  • 目录结构
  • 生成文件

Hertz性能

01.网络库Netpoll

02.Json编解码Sonic

03.使用 sync.Pool 复用对象协议层数据解析优化

Hertz生态

Hertz拥有非常丰富的扩展生态,以下列举一部分常用扩展。