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

扁桃体不发言
441 阅读4分钟

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

一、本节课重点内容

1. 三件套（Gorm、Kitex、Hertz）介绍

2. 三件套的基本用法

二、详细知识点介绍

1. 三件套介绍

Gorm

Gorm是一个已经迭代了10年+的功能强大的ORM框架，拥有非常丰富的开源扩展

Kitex

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

Hertz

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

2. Gorm的基础使用

Gorm的基本使用

  • Gorm使用名为ID的字段作为主键
  • 使用结构体的蛇形负数作为表名
  • 字段名的蛇形作为列名
  • 使用CreateAt、UpdateAt字段作为创建、更新时间 Snipaste_2023-01-19_14-17-43.png

Gorm支持的数据库

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

Gorm查询数据

  • 使用First时，需要注意查询不到数据会返回ErrRecordNotFound
  • 使用Find查询多条数据，查询不到数据不会返回错误
  • 可以使用结构体作为查询条件
  • 当使用结构体作为条件查询时，Gorm只会查询非零值字段 Snipaste_2023-01-19_14-28-50.png

Gorm更新数据

  • 使用Struct更新时，只会更新非零值，如果需要更新零值，可以使用Map更新或使用Select选择字段
  • 使用Find查询多条数据，查询不到数据不会返回错误
  • 可以使用结构体作为查询条件
  • 当使用结构体作为条件查询时，Gorm只会查询非零值字段 Snipaste_2023-01-19_14-29-04.png

Gorm删除数据

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

Gorm事务

  • Gorm提供了Begin、Commit、Rollback方法用于使用事务 Snipaste_2023-01-19_14-34-41.png
  • Gorm提供了Tansaction方法用于自动提交事务，避免用户漏写Commit、Rollback Snipaste_2023-01-19_14-36-53.png

Gorm Hook

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

Gorm生态

Gorm拥有非常丰富的扩展生态 image.png

3. Kitex的基础使用

目前Kitex对Windows的支持不完善，如果本地开发环境是Windows，建议使用虚拟机或者WSL2。Kitex服务默认监听8888端口

定义IDL

如果我们要进行RPC，就需要知道对方的接口是什么，需要传什么参数，同时也需要知道返回值是什么样的。这个时候就需要通过IDL来约定双方的协议。

Kitex生成代码

使用Kitex -module example -service example echo.thrift命令生成代码 Snipaste_2023-01-19_14-44-34.png

  • build.sh：构建脚本
  • kitex_gen：IDL内容相关的生成代码，主要是基础的Service/Client代码
  • main.go：程序入口
  • handler.go：用户在该文件里实现IDL service定义的方法

Kitex Client发起请求

  • 创建Client Snipaste_2023-01-19_14-48-14.png
  • 发起请求 Snipaste_2023-01-19_14-48-23.png

Kitex服务注册于发现

Kitex的服务注册与发现已经对接了主流的服务注册与发现中心，如ETCD、Nacos等 Snipaste_2023-01-19_14-50-40.png

Kitex生态

Kite拥有非常丰富的扩展生态 image.png

4. Hertz的基础使用

hertz路由

  • Hertz提供了GET、POST、PUT、DELETE、ANY等方法用于注册路由 Snipaste_2023-01-19_15-12-22.png
  • Hertz提供了路由组（Group）的能力，用于支持路由分组的功能 Snipaste_2023-01-19_15-13-33.png
  • Hertz提供了参数路由和通配路由，路由的优先级为：静态路由>命名路由>通配路由 Snipaste_2023-01-19_15-14-57.png

hertz参数绑定

  • Hertz提供了Bind、Validate、BindAndValidate函数用于进行参数绑定和校验 Snipaste_2023-01-19_15-16-41.png

hertz中间件

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

hertz Client

Hertz提供了HTTP Client用于帮助用户发送HTTP请求 Snipaste_2023-01-19_15-19-46.png

hertz代码生成工具

Hertz提供了代码生成工具Hz，通过定义IDL（interface description language）文件即可生成对应的基础服务代码 Snipaste_2023-01-19_15-20-02.png

Hertz生态

Hertz拥有非常丰富的扩展生态 image.png

三、课后个人总结

经过课程的学习，对Gorm、Kitex、Hertz有了一个初步的了解，熟悉了Gorm、Kitex、Hertz的基础用法，在课后还需要多阅读官方文档进一步熟悉Gorm、Kitex、Hertz的使用。

avatar
文章
阅读
粉丝