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

前言

三件套介绍

1. Gorm：ORM框架，作用于开源扩展
2. Kitex：Golang微服务，RPC框架，具有高性能、强可扩展
3. Hertz：HTTO框架，高易用、高性能、高扩展

1.1 Gorm的基本使用

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)
}

1.2 Gormde 的约定

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

1.3Gorm支持的数据库

目前支持MySQL、SQLServer、postgreSQL、SQLite

1.4Gorm特性

• 全功能 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…

• 每个特性都经过了测试的重重考验

• 开发者友好

1.5Gorm的使用

// 一个例子 struct
type User struct {
  ID           uint
  Name         string
  Email        *string
  Age          uint8
  Birthday     *time.Time
  MemberNumber sql.NullString
  ActivatedAt  sql.NullTime
  CreatedAt    time.Time
  UpdatedAt    time.Time
}

1.6Gorm链接数据库

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

func main() {

  dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
  db, err := gorm.Open(mysql.New(mysql.Config{
  DSN: "gorm:gorm@tcp(127.0.0.1:3306)/gorm?charset=utf8&parseTime=True&loc=Local", // DSN data source name
  DefaultStringSize: 256, // string 类型字段的默认长度
  DisableDatetimePrecision: true, // 禁用 datetime 精度，MySQL 5.6 之前的数据库不支持
  DontSupportRenameIndex: true, // 重命名索引时采用删除并新建的方式，MySQL 5.7 之前的数据库和 MariaDB 不支持重命名索引
  DontSupportRenameColumn: true, // 用 `change` 重命名列，MySQL 8 之前的数据库和 MariaDB 不支持重命名列
  SkipInitializeWithVersion: false, // 根据当前 MySQL 版本自动配置
}), &gorm.Config{})
}
//以MYSQL为例