预加载

GORM 允许在 Preload 的其它 SQL 中直接加载关系，例如：

1. type User struct {
2. gorm.Model
3. Username string
4. Orders   []Order
5. }

7. type Order struct {
8. gorm.Model
9. UserID uint
10. Price  float64
11. }

13. // 查找 user 时预加载相关 Order
14. db.Preload("Orders").Find(&users)
15. // SELECT * FROM users;
16. // SELECT * FROM orders WHERE user_id IN (1,2,3,4);

18. db.Preload("Orders").Preload("Profile").Preload("Role").Find(&users)
19. // SELECT * FROM users;
20. // SELECT * FROM orders WHERE user_id IN (1,2,3,4); // has many
21. // SELECT * FROM profiles WHERE user_id IN (1,2,3,4); // has one
22. // SELECT * FROM roles WHERE id IN (4,5,6); // belongs to

Joins 预加载

Preload 在一个单独查询中加载关联数据。而 Join Preload 会使用 inner join 加载关联数据，例如：

1. db.Joins("Company").Joins("Manager").Joins("Account").First(&user, 1)
2. db.Joins("Company").Joins("Manager").Joins("Account").First(&user, "users.name = ?", "jinzhu")
3. db.Joins("Company").Joins("Manager").Joins("Account").Find(&users, "users.id IN ?", []int{1,2,3,4,5})

带条件的 Join

1. db.Joins("Company", DB.Where(&Company{Alive: true})).Find(&users)
2. // SELECT `users`.`id`,`users`.`name`,`users`.`age`,`Company`.`id` AS `Company__id`,`Company`.`name` AS `Company__name` FROM `users` LEFT JOIN `companies` AS `Company` ON `users`.`company_id` = `Company`.`id` AND `Company`.`alive` = true;

注意 Join Preload 适用于一对一的关系，例如： has one, belongs to

预加载全部

与创建、更新时使用 Select 类似，clause.Associations 也可以和 Preload 一起使用，它可以用来 预加载 全部关联，例如：

1. type User struct {
2. gorm.Model
3. Name       string
4. CompanyID  uint
5. Company    Company
6. Role       Role
7. Orders     []Order
8. }

10. db.Preload(clause.Associations).Find(&users)

clause.Associations 不会预加载嵌套的关联，但你可以使用嵌套预加载 例如：

1. db.Preload("Orders.OrderItems.Product").Preload(clause.Associations).Find(&users)

带条件的预加载

GORM 允许带条件的 Preload 关联，类似于内联条件

1. // 带条件的预加载 Order
2. db.Preload("Orders", "state NOT IN (?)", "cancelled").Find(&users)
3. // SELECT * FROM users;
4. // SELECT * FROM orders WHERE user_id IN (1,2,3,4) AND state NOT IN ('cancelled');

6. db.Where("state = ?", "active").Preload("Orders", "state NOT IN (?)", "cancelled").Find(&users)
7. // SELECT * FROM users WHERE state = 'active';
8. // SELECT * FROM orders WHERE user_id IN (1,2) AND state NOT IN ('cancelled');

自定义预加载 SQL

您可以通过 func(db *gorm.DB) *gorm.DB 实现自定义预加载 SQL，例如：

1. db.Preload("Orders", func(db *gorm.DB) *gorm.DB {
2. return db.Order("orders.amount DESC")
3. }).Find(&users)
4. // SELECT * FROM users;
5. // SELECT * FROM orders WHERE user_id IN (1,2,3,4) order by orders.amount DESC;

嵌套预加载

GORM 支持嵌套预加载，例如：

1. db.Preload("Orders.OrderItems.Product").Preload("CreditCard").Find(&users)

3. // 自定义预加载 `Orders` 的条件
4. // 这样，GORM 就不会加载不匹配的 order 记录
5. db.Preload("Orders", "state = ?", "paid").Preload("Orders.OrderItems").Find(&users)