导读

本套笔记是学习完Gin框架之后的下一个阶段，通过Gin框架我们可以很方便的和前端进行交互，下一步就是和数据库进行交互，这就需要使用GORM。本套笔记就是带你快速上手GORM，学习完这个之后就可以完成大项目的开发了，后续还会进行大项目的讲解开发，制作不易，喜欢的就点个关注吧。

本套课程基于GORM 指南 | GORM - The fantastic ORM library for Golang, aims to be developer friendly.进行讲解，是对这个的补充解释说明。

注意

代码详解大部分是注释的形式给出，请留意代码注释。

GORM介绍

GORM（Go Object Relational Mapping）是一个在 Go 语言中使用的优秀的 ORM（对象关系映射）库。它提供了简单且强大的 API，使开发人员能够轻松地与数据库进行交互

安装

我们只需要打开goland的控制台，输入

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

就可以完成安装

在这里输入上方的代码运行

模型

官方定义：模型是标准的 struct，由 Go 的基本数据类型、实现了 Scanner 和 Valuer 接口的自定义类型及其指针或别名组成

其实就是数据库表的结构体对象

例如如果一个数据库包含Id，Name，Age，Gender，Email，那么他的模型就是

type User struct {
  ID           uint
  Name         string
  Email        *string
  Age          uint8
  Gender       string
  CreatedAt    time.Time//创建时间
  UpdatedAt    time.Time//更新时间
}

约定

GORM 使用 ID 作为主键，使用结构体名的 蛇形复数 作为表名，并使用 CreatedAt、UpdatedAt 字段追踪创建、更新时间。

主键

主键（Primary Key）是数据库表中用于唯一标识每个记录的字段或一组字段。

1. 唯一性：主键的值在整个表中必须是唯一的，不允许重复出现。这样可以确保每条记录在表中有唯一的标识。
2. 非空性：主键字段的值不能为空，每条记录都必须有一个有效的主键。这样可以避免将空值作为标识符。
3. 稳定性：主键的值在记录创建后一般不会发生变化，或者在发生变化时能够得到适当的处理。这样可以保持主键的稳定性，确保它作为记录的标识符的一致性。

你可以通过标签 primaryKey 将其它字段设为主键

type Animal struct {
  ID     int64
  UUID   string `gorm:"primaryKey"`
  Name   string
  Age    int64
}

蛇形复数

蛇形复数（Snake Case）指的是一种命名约定，用于将多个单词连接在一起，通过在单词之间使用下划线（_）作为分隔符。

以下是一些使用蛇形复数的示例：

• 变量名：first_name、last_name、phone_number
• 函数名：calculate_average、get_user_list、validate_input
• 文件名：user_model.go、database_utility.py、config_properties.ini

gorm.Model

GORM 定义一个 gorm.Model 结构体，其包括字段 ID、CreatedAt、UpdatedAt、DeletedAt

type Model struct {
  ID        uint           `gorm:"primaryKey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
}

嵌入结构体

对于匿名字段，GORM 会将其字段包含在父结构体中，例如：

type User struct {
  gorm.Model
  Name string
}
// 等效于
type User struct {
  ID        uint           `gorm:"primaryKey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
  Name string
}

对于正常的结构体字段，你也可以通过标签 embedded 将其嵌入

type Author struct {
   Name  string    
   Email string 
}
type Blog struct {
  ID      int
  Author  Author `gorm:"embedded"`
  Upvotes int32
}
// 等效于
type Blog struct {
  ID    int64
  Name  string
  Email string
  Upvotes  int32
}

可以使用标签 embeddedPrefix 来为 db 中的字段名添加前缀

type Blog struct {
  ID      int
  Author  Author `gorm:"embedded;embeddedPrefix:author_"`
  Upvotes int32
}
// 等效于
type Blog struct {
  ID          int64
  AuthorName string
  AuthorEmail string
  Upvotes     int32
}

字段标签

一个神奇的玩意。GORM提供了许多有用的标签

连接到数据库

GORM 官方支持的数据库类型有：MySQL, PostgreSQL, SQLite, SQL Server 和 TiDB。

我们使用MySQL来进行讲解。

连接MySQL

import (
  "gorm.io/driver/mysql"
  "gorm.io/gorm"
)
func main() {
  dsn := "user:pass@tcp(127.0.0.1:3306)/dbnamecharset=utf8mb4&parseTime=True&loc=Local"
  db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
 }

user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local是一个完整的数据库连接字符串示例，包含了用户名、密码、数据库地址、数据库名称以及其他参数。

具体解释如下：

• user:pass：表示数据库连接所使用的用户名和密码。你需要将其替换为实际的用户名和密码，用于连接到数据库服务器。
• tcp(127.0.0.1:3306)：指定数据库服务器的地址和端口号。这里的示例是连接到本地主机上运行的 MySQL 数据库服务器，默认端口号是 3306。
• /dbname：指定要连接的数据库名称。你需要将其替换为你要连接的实际数据库的名称。
• ?charset=utf8mb4&parseTime=True&loc=Local：表示连接的其他参数，包括字符集、时间解析以及时区设置

user:pass和dbname是需要更改成你自己的

高级连接

需要的时候复制粘贴即可

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

• DSN 字段指定数据库连接字符串，包含用户名、密码、数据库地址、数据库名称以及其他参数。
• DefaultStringSize 字段指定 string 类型字段的默认长度为 256。
• DisableDatetimePrecision 字段禁用 datetime 精度，因为 MySQL 5.6 之前的数据库不支持此特性。
• DontSupportRenameIndex 字段禁止重命名索引时采用删除并新建的方式，因为 MySQL 5.7 之前的数据库和 MariaDB 不支持重命名索引。
• DontSupportRenameColumn 字段禁止使用 change 来重命名列，因为 MySQL 8 之前的数据库和 MariaDB 不支持重命名列。
• SkipInitializeWithVersion 字段根据当前 MySQL 版本自动配置。