初入GO框架三件套|青训营笔记

92 阅读3分钟

初入GO框架三件套|青训营笔记

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

在后面会依次倒叙回顾之前的学习课程,便于复习~

一、课程重点内容

  • 三件套的介绍
  • 三件套的基本用法
  • 实战案例介绍

下面是对课程重点内容的思考与总结,有问题或者错误,可以批评指正呐~

二、三件套介绍

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

三、三件套的使用

  • Gorm的基本使用

    • 基本使用:
image-20230205195751669.png
  • Gorm的踩坑

    • Gorm使用名为ID的字段作为主键

    • 使用结构体的蛇形负数作为表名

    • 字段名的蛇形作为列名

    • 使用CreatedAt、UpdatedAt字段作为创建、更新时间

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

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

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

      • 凡是有利必有弊,在具体的场合中使用此字段时,默认会被赋予索引的条件,这就导致,唯一索引的失效,为了解决此问题推荐使用soft_delete
  • Kitex的基本使用

    Kitex目前对 Windows 的支持不完善,目前我用的是Windows,于是只能采用WSL2开发,注意千万不能是WSL1,会有各种奇怪的bug。

    • 定义IDL

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

    image-20230206102704069.png

    • 生成代码

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

      image-20230206102844997.png

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

    • 路由:

      • Hertz 提供了 GET、POST、PUT、DELETE、ANY等方法用于注册路由,
      • 同时提供了路由组(Group)的能力,用于支持路由分组的功能
      • 也提供了参数路由和通配路由,路由的优先级为:静态路由>命名路由>通配路由
    • 参数绑定:Hertz提供了 Bind、 Validate、 BindAndValidate 函数用于进行参数绑定和校验

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

四、实战案例介绍

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

服务名称服务介绍传输协议主要技术栈
demoapiAPI服务HTTPKitex/Hertz
demouser用户数据管理ProtobufGorm/Kitex
demonote笔记数据管理ThriftGorm/Kitex

image-20230206103718920.png

image-20230206103745576.png

image-20230206103815999.png

五、课程总结

  • 了解Gorm/Kitex/Hertz是什么
  • 熟悉Gorm/Kitex/Hertz的基础用法
  • 通过实战案例分析将三个框架的使用串联了起来