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=%v\n", product)
    db.First(&product, "code = ?", "D42") // 查找 code 字段值为 D42 的记录
    fmt.Printf("First D42=%v\n", 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 字段.

gorm基础01--人门指南-概述_字段

注意

  1. gorm 默认使用软删除，即deleted_at 设置为指定的时间即可，没有实际删除数据; 若需要实际删除，那么需要做如下调整：
// Delete - 删除 product（软删除）
 db.Delete(&product, 1)
 // 硬删除
 db.Where("id = ?", 1).Unscoped().Delete(&Product{})

说明

​​GORM 指南-概述​​