Go框架三件套详解 ｜ 青训营笔记

rrrgo
177 阅读5分钟

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

Go框架三件套详解（Web/RPC/ORM）

这章会介绍Hertz/Kitex/Gorm的基本用法，并通过学习实战案例应用到后端开发任务。

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

三件套的使用

Gorm的基础使用

image.png

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

Gorm支持的数据库

Gorm目前支持MySQL、SQLServer、PostgreSQL、SQLite。

image.png GORM通过驱动来连接数据库，如果需要连接其他类型的数据库，可以复用/自行开发驱动。

Gorm创建数据

image.png

  • 可以使用clause.OnConflict处理数据冲突

image.png

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

image.png

Gorm查询数据

image.png

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

Gorm更新数据

image.png

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

Gorm删除数据

  • 物理删除

image.png

  • 软删除

image.png

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

Gorm事务

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

image.png

Gorm提供了Transaction方法用于自动提交事务，避免用户漏写Commit、Rollback。

image.png

Gorm Hook

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

Gorm性能提高

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

Gorm生态

GORM拥有非常丰富的扩展生态，以下为一部分常用扩展：

image.png

Kitex的基础使用

定义IDL

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

Kitex生成代码

image.png

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

Kitex基本使用

服务默认监听8888端口：

image.png

Kitex Client发起请求

  • 创建Client：

image.png

  • 发起请求

image.png

Kitex服务注册与发现

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

image.png

服务注册与发现

image.png

Kitex生态

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

image.png

Hertz的基础使用

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

image.png

Hertz路由

  • Hertz提供了GET、POST、PUT、DELETE、ANY等方法用于注册路由。

image.png

  • Hertz提供了路由组（Group）的能力，用于支持路由分组的功能。

image.png

  • Hertz提供了参数路由和通配路由，路由的优先级分为：静态路由>命名路由>统配路由。

image.png

Hertz参数绑定

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

image.png

Hertz中间件

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

image.png

  • 以下命令可以终止中间件调用链的执行：
    • c.Abort
    • c.AbortWithMsg
    • c.AbortWithStats

Hertz Client

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

image.png

Hertz代码生成工具

Hertz提供了代码生成工具Hz，通过定义IDL（interface description language）文件即可生成对应的基础服务代码。

image.png

  • 目录结构 image.png

  • 生成文件

image.png

Hertz性能

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

Hertz生态

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

image.png

总结

这章介绍了Hertz/Kitex/Gorm的基本用法，下一章会通过实战案例来学习如何应用到后端开发任务。

avatar
文章
阅读
粉丝