Go框架三件套详解 | 青训营

已注销
112 阅读5分钟

这是我参与[第五届青训营]伴学笔记创作活动的第5天。

01 课程介绍

课程目标

  1. 将前面几节课所学到的知识应用到项目中。
  2. 掌握Hertz/Kitex/Gorm 的基本用法。
  3. 通过学习实战案例,可以使用Hertz/Kitex/Gorm完成日常后端开发任务

三件套介绍

  1. Gorm：Gorm是一个已经迭代了10年+的功能强大的ORM框架，在字节内部被广泛使用并且拥有非常丰富的开源扩展。
  2. Kitex：Kitex是字节内部的Golang微服务RPC框架,具有高性能、强可扩展的主要特点,支持多协议并且拥有丰富的开源扩展。
  3. Hertz：Hertz是字节内部的HTTP框架,参考了其他开源框架的优势,结合字节跳动内部的需求,具有高易用性、高性能、高扩展性特点。

02 三件套的使用

2.1.1 Gorm的基本使用

  • Gorm的约定(默认)
  • Gorm使用名为ID的字段作为主键
  • 使用结构体的蛇形负数作为表名
  • 字段名的蛇形作为列名
  • 使用CreatedAt.UpdaledAt字段作为创建,更新时间

f8a031522676b4779ea8b6e6b3a3003.pngGorm支持的数据库

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

Gorm创建数据

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

GORM查询数据

First的使用踩坑

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

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

  • 物理删除db.delete

  • 软删除

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

GORM事务

Gorm提供了Begin、Commit、Rollback方法用于使用事务

GORM Hook

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

GORM性能提高

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

GORM生态

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

安装Kitex代码生成工具 Kitex目前对Windows 的支持不完善，如果本地开发环境是Windows 的同学建议使用虚拟机或WSL2.

安装代码生成工具

  • go install github.com/cloudwego/kitex/tool/cmd/kitex@latest
  • go install github.com/cloudwego/thriftgo@latest

定义IDL

使用IDL定义服务与接口

如果我们要进行RPC，就需要知道对方的接口是什么,需要传什么参数,同时也需要知道返回值是什么样的。这时候,就需要通过IDL来约定双方的协议,就像在写代码的时候需要调用某个函数，我们需要知道函数签名一样。

Kitex生成代码

使用kitex -module example -service example echo.thrift命令生成代码。

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

Kitex基本使用

服务默认监听8888端口

Kitex服务注册与发现

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

Kitex生态

Kitex拥有非常丰富的扩展生态，以下列举一部分常用扩展。100baa996a64b25576fe9665fee4c58.png

Hertz基本使用

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

Hertz路由

  • Hertz提供了GET、POST、PUT、DELETE、ANY 等方法用于注册路由。
  • Hertz提供了参数路由和通配路由，路由的优先级为:静态路由>命名路由>通配路由

Hertz参数绑定

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

Hertz中间件

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

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

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

Hertz Client

Her也z提供了HTTP Client用于帮助用户发送HTTP请求

Hertz代码生成工具

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

Hertz性能

  1. 网络库Netpoll
  2. Json编解码Sonic
  3. 使用sync.Pool复用对象协议层数据解析优化

Hertz生态

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

9fe9ab0e400b320afb6ecab804c2e8c.png

03实战训练

项目介绍

笔记项目是一个使用Hertz 、Kitex、Gorm搭建出来的具备一定业务逻辑的后端API项目

3ba8f19b11be39e2b39593b294ef6a6.pnggithub.com/cloudwego/k…

功能介绍

7a83fd3cfe5cf40ee14c27044681c61.png

项目调用关系

857e053c3144073d6e78f70d8312c50.png

总结

Hertz是一个用于 Go的高性能、高可用性、可扩展的HTTP 框架。它旨在为开发人员简化构建微服务。GROM是一个致力于开发者友好、极好的Golang ORM类库，支持多种数据库。kitex为字节开源的rpc框架，与go-micro等不同，kitex主打强扩展性，在协议上不仅支持Thrift(Buffered与Framed),同时也支持Kitex Protobuf等。学习Go的三种框架工具，以更好构建高质量的项目，促进工作的完成。

avatar
文章
阅读
粉丝