Go实践—初识Gorm框架

CRUD

当我们建立好连接后就要开始增删改查了。

Create——增

在GORM中，框架提供了Create()方法来新建一条记录：

user := User{
		Name:     "Nick",
		Age:      "19",
		NickName: "AAA",
	}

	result := db.Create(&user)
	//如果想要判断创建结果是否成功，只需要调用result.Error即可
	if result.Error != nil {
		fmt.Println("创建失败")
	}
	//返回记录的ID
	fmt.Println("Id = ", user.ID)
	//返回插入记录的条数
	fmt.Println("Rows = ", result.RowsAffected)

运行后我们此时查看表：

mysql> SELECT * FROM users;
+----+-------------------------+-------------------------+------------+------+------+-----------+
| id | created_at              | updated_at              | deleted_at | name | age  | nick_name |
+----+-------------------------+-------------------------+------------+------+------+-----------+
|  1 | 2023-07-28 19:29:18.168 | 2023-07-28 19:29:18.168 | NULL       | Nick | 19   | AAA       |
+----+-------------------------+-------------------------+------------+------+------+-----------+
1 row in set (0.00 sec)

当然你也可以通过传入一个切片的方式来批量增加记录：

users := []*User{
		&User{
			Name: "A",
			Age: "15",
			NickName: "a",
		},
		&User{
			Name:     "B",
			Age:      "16",
			NickName: "b",
		},
	}
	

	result := db.Create(&users)
	//如果想要判断创建结果是否成功，只需要调用result.Error即可
	if result.Error != nil {
		fmt.Println("创建失败")
	}
	//返回插入记录的条数
	fmt.Println("Rows = ", result.RowsAffected)

运行后查看原表：

mysql> SELECT * FROM users;
+----+-------------------------+-------------------------+------------+------+------+-----------+
| id | created_at              | updated_at              | deleted_at | name | age  | nick_name |
+----+-------------------------+-------------------------+------------+------+------+-----------+
|  1 | 2023-07-28 19:29:18.168 | 2023-07-28 19:29:18.168 | NULL       | Nick | 19   | AAA       |
|  2 | 2023-07-28 19:33:38.961 | 2023-07-28 19:33:38.961 | NULL       | A    | 15   | a         |
|  3 | 2023-07-28 19:33:38.961 | 2023-07-28 19:33:38.961 | NULL       | B    | 16   | b         |
+----+-------------------------+-------------------------+------------+------+------+-----------+
3 rows in set (0.00 sec)

Read——查

GORM 提供了 First、Take、Last 方法，以便从数据库中检索单个对象。当查询数据库时它添加了 LIMIT 1 条件，且没有找到记录时，它会返回 ErrRecordNotFound 错误

user := User{}

// 获取第一条记录（主键升序）
db.First(&user)
// SELECT * FROM users ORDER BY id LIMIT 1;
fmt.Println(user)

// 获取一条记录，没有指定排序字段
db.Take(&user)
// SELECT * FROM users LIMIT 1;
fmt.Println(user)

// 获取最后一条记录（主键降序）
db.Last(&user)
// SELECT * FROM users ORDER BY id DESC LIMIT 1;
fmt.Println(user)

result := db.First(&user)
fmt.Println(result.RowsAffected) // 返回找到的记录数
if result.Error != nil {         // returns error or nil
	fmt.Println(result.Error)
}

// 检查 ErrRecordNotFound 错误
if errors.Is(result.Error, gorm.ErrRecordNotFound) {
	fmt.Println("找不到记录")
}

WHERE

在GORM中，也提供了和SQL类似的WHERE方法来过滤我们的查询结果。并且在WHERE内的查询语句是和SQL的语法基本一致的。

// Get first matched record
db.Where("name = ?", "Nick").First(&user)
// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1;

// Get all matched records
db.Where("name  ?", "A").Find(&users)
// SELECT * FROM users WHERE name  'jinzhu';

// IN
db.Where("name IN ?", []string{"A", "B"}).Find(&users)
// SELECT * FROM users WHERE name IN ('jinzhu','jinzhu 2');

// LIKE
db.Where("name LIKE ?", "%Ni%").Find(&users)
// SELECT * FROM users WHERE name LIKE '%jin%';

// AND
db.Where("name = ? AND age >= ?", "Nick", "10").Find(&users)
// SELECT * FROM users WHERE name = 'jinzhu' AND age >= 22;

// BETWEEN
db.Where("age BETWEEN ? AND ?", "5", "15").Find(&users)
// SELECT * FROM users WHERE age BETWEEN '5' AND '15';

Update——改

当我们通过查询方法拿到记录后，我们可以更改这个结构体来更改记录，而后使用Save方法来更新字段：

user := User{}

	db.First(&user)

	//拿到记录后我们直接更改记录即可
	user.Name = "Luna"
	db.Save(&user)

	//有一个特性，如果你传入的结构体内没有包含主键的话，那么此时Save会调用Create方法

	userWithoutId := User{
		Name: "123",
	}
	//这里便是Create方法，相当于SQL的INSERT
	db.Save(&userWithoutId)

	userWithId := User{Model: gorm.Model{ID: 1}, Name: "s"}
	//这里便是Save方法，相当于SQL的UPDATE
	db.Save(&userWithId)

DELETE——删

首先确定两个概念：

为什么引入这两个概念，这里留给读者自行思考。

在GORM中也有着删除的方法：Delete:

user := User{
	Age: "16",
}

db.Delete(&user)
// DELETE from users where age = '16';

db.Where("name = ?", "s").Delete(&user)
// DELETE from users where name = 's' and age = '16';

注意的时，由于我们没有指定主键，因此GORM会删除一切符合筛选条件的记录。

如果我们根据主键删除：

db.Delete(&user, 1)
// DELETE from users where id = 1 and age = '16';

db.Delete(&user, []int{1, 2, 3})
// DELETE from users where id in (1,2,3) and age = '16';

软删除和硬删除

GORM中，当你的结构体携带有gorm.DeletedAt字段时，此时GORM将不会直接删除记录，而是会将这个字段的值更新为当前时间，再使用GORM的查询时一般是无法查询到该记录的。但你可以使用Unscoped来查询到被软删除的记录。

var users []User
db.Unscoped().Where("age = '16'").Find(&users)
// SELECT * FROM users WHERE age = '16';

你也可以使用 Unscoped来永久删除匹配的记录

db.Unscoped().Delete(&user)
// DELETE FROM users WHERE age = '16';

总结

GORM 作为Go 比较成熟的ORM 框架，它的业务能力是有目共睹的。对于新手而言，若要快速学习与SQL的交互，从GORM入手也许是一个不错的选择。

同时GORM还有着更多好玩的特性，下篇文章笔者将尝试讲解将Gin和Gorm结合起来的实际应用。

本文示例代码已放在仓库内

参考文档

• Gorm官方文档

• ORM实例手册

大白菜程序猿

goorm数据库 开发运维

0 0

大白菜程序猿

这个人很懒，什么都没有留下～

文章8480 评论0

• 服务器端口转发，带你了解服务器端口转发

• 百度搜索：蓝易云 – Linux之查看系统性能命令大全

• MySQL 主从复制的问题及解决方案