gorm基础01--人门指南-概述

• 介绍
• 案例
• 注意
• 说明

gorm是一个神奇的，对开发人员友好的 Golang ORM 库，其功能全面，具体包括如下特性：

• 全功能 ORM (几乎包含所有特性)
• 模型关联 (一对一， 一对多，一对多（反向）， 多对多， 多态关联，单表继承)
• 钩子 (包括 Before/After 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，命名参数，子查询
• 复合主键，索引，约束
• 自动迁移
• 自定义日志
• 灵活的可扩展插件 API：Database Resolver（多数据库，读写分离）、Prometheus…
• 全特性测试覆盖
• 开发者友好

安装

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

源码：

package main

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

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) // 根据整型主键查找
	fmt.Printf("First=%vn", product)
	db.First(&product, "code = ?", "D42") // 查找 code 字段值为 D42 的记录
	fmt.Printf("First D42=%vn", product)
	// 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)
}

测试：

安装sqlite 和 sqlitebrowser
apt-get install sqlite sqlite3 sqlitebrowser

终端输出：
2022/04/05 20:50:47 /home/xg/files/code/golang/gorm/orm01/main.go:29 record not found
[0.115ms] [rows:0] SELECT * FROM `products` WHERe `products`.`id` = 1 AND `products`.`deleted_at` IS NULL ORDER BY `products`.`id` LIMIT 1
First={{0 0001-01-01 00:00:00 +0000 UTC 0001-01-01 00:00:00 +0000 UTC {0001-01-01 00:00:00 +0000 UTC false}}  0}
First D42={{4 2022-04-05 20:50:47.413409183 +0800 +0800 2022-04-05 20:50:47.413409183 +0800 +0800 {0001-01-01 00:00:00 +0000 UTC false}} D42 100}

如下图，该案例生成一个 products 表，表中有默认的id 字段， 和 Product 中的code 、price 字段; 并附加了 created_at updated_at deleted_at 等字段，delete 的时候会更新deleted_at 字段.

1. gorm 默认使用软删除，即deleted_at 设置为指定的时间即可，没有实际删除数据; 若需要实际删除，那么需要做如下调整：

    // Delete - 删除 product（软删除）
    db.Delete(&product, 1)
    // 硬删除
    db.Where("id = ?", 1).Unscoped().Delete(&Product{})
   

GORM 指南-概述