Go 语言主流开发框架| 青训营笔记

63 阅读4分钟

这是我参与「第五届青训营」伴学笔记创作活动的第 4 天,这次通过录播课学习了字节内部使用的开发框架。

1.GORM

Object-Relationl Mapping,即对象关系映射,这里的Relationl指的是关系型数据库。

它的作用是在关系型数据库和对象之间作一个映射,这样,我们在具体的操作数据库的时候,就不需要再去和复杂的SQL语句打交道,只要像平时操作对象一样操作它就可以了。

DSN是数据源名称Data Source Name,是应用程序用来请求与ODBC数据源连接的名称。连接到ODBC时,它会存储连接详细信息,例如数据库名称、目录、数据库驱动程序、UserID、password等。

GORM特性

  • 全功能 ORM
  • 关联 (Has One,Has Many,Belongs To,Many To Many,多态,单表继承)
  • Create,Save,Update,Delete,Find 中钩子方法
  • 支持 PreloadJoins 的预加载
  • 事务,嵌套事务,Save Point,Rollback To Saved Point
  • Context、预编译模式、DryRun 模式
  • 批量插入,FindInBatches,Find/Create with Map,使用 SQL 表达式、Context Valuer 进行 CRUD
  • SQL 构建器,Upsert,数据库锁,Optimizer/Index/Comment Hint,命名参数,子查询
  • 复合主键,索引,约束
  • Auto Migration
  • 自定义 Logger
  • 灵活的可扩展插件 API:Database Resolver(多数据库,读写分离)、Prometheus…
  • 每个特性都经过了测试的重重考验
  • 开发者友好

GORM安装

go get -u gorm.io/gorm
go get -u gorm.io/driver/sqlite

Quick Start

package main

import (
  "gorm.io/gorm"
  "gorm.io/driver/sqlite"
)

type Product struct {
  gorm.Model
  Code  string
  Price uint
}

func main() {
  db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
  if err != nil {
    panic("failed to connect database")
  }

  // 迁移 schema
  db.AutoMigrate(&Product{})

  // Create
  db.Create(&Product{Code: "D42", Price: 100})

  // Read
  var product Product
  db.First(&product, 1) // 根据整型主键查找
  db.First(&product, "code = ?", "D42") // 查找 code 字段值为 D42 的记录

  // Update - 将 product 的 price 更新为 200
  db.Model(&product).Update("Price", 200)
  // Update - 更新多个字段
  db.Model(&product).Updates(Product{Price: 200, Code: "F42"}) // 仅更新非零值字段
  db.Model(&product).Updates(map[string]interface{}{"Price": 200, "Code": "F42"})

  // Delete - 删除 product
  db.Delete(&product, 1)
}

建议看官网学习:GORM 指南 | GORM - The fantastic ORM library for Golang, aims to be developer friendly.

Kitex

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

安装代码生成工具

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

定义IDL

IDL是什么?

IDL是Interface description language的缩写,指接口描述语言,是规范的一部分,是跨平台开发的基础。

RPC是什么:

RPC(Remote Procedure Call Protocol)远程过程调用协议。一个通俗的描述是:客户端在不知道调用细节的情况下,调用存在于远程计算机上的某个对象,就像调用本地应用程序中的对象一样。比较正式的描述是:一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的协议。

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

namespace go api

struct Request {
    1: string message
}

struct Response {
    1: string message
}

service Echo {
    Response echo(1: Request req)
}

Kitex生成代码

建议官网学习http://www.cloudwego.io/zh/docs/kitex/getting-started/

使用如下命令生成代码:

kitex -module example -service example echo.thrift

文件说明:

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

服务默认监听8888端口;

Kitex Client发起请求:

  • 创建Client
  • 发起请求

Kitex服务注册与发现:

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

Kitex生态:

详见:https://www.cloudwego.io/zh/docs/kitex/


Hertz

建议官网学习:https://www.cloudwego.io/zh/docs/hertz/getting-started/

Hertz路由

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

提供了路由组Group的能力,用于支持路由分组功能;

提供了参数路由和通配路由,路由的优先级为:静态路由 > 命名路由 > 通配路由

Hertz参数绑定

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

Hertz中间件

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

Hertz Client

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

Hertz代码生成工具

Hertz提供了代码生成工具Hz,通过定义IDL文件即可生成对应的基础服务代码;