这是我参与「第五届青训营」伴学笔记创作活动的第 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 中钩子方法
- 支持
Preload、Joins的预加载 - 事务,嵌套事务,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文件即可生成对应的基础服务代码;