模型创建
Model
Model方法用于创建基于数据表的Model对象。常见的，也可以使用g对象管理模块中的Model方法在默认的数据库配置上创建Table/Model方法用于创建指定数据表的Model对象。
使用示例：
| Code Block | ||
|---|---|---|
| ||
m := g.DB().TableModel("user") m := // 或者 g.DB().Model("user") |
此外，在某些场景下，我们也可以通过DB方法切换当前模型的数据库对象，例如：
| Code Block | ||
|---|---|---|
| ||
m := g |
.Model("user") m = m.DB(g.DB(" |
order")) |
其效果与以下操作是一样的：
| Code Block | ||
|---|---|---|
| ||
m := g.DB("user |
").Model("user") |
Raw
Raw方法用于创建一个基于原始SQL语句的Model对象。也可以使用g对象管理模块中的ModelRaw方法通过给定的SQL语句在默认的数据库配置上创建Model对象。
| Code Block | ||
|---|---|---|
| ||
s := "SELECT * FROM `user`"
m, _ := g.ModelRaw(s).WhereLT("age", 18).Limit(10).OrderAsc("id").All()
// SELECT * FROM `user` WHERE `age`<18 ORDER BY `id` ASC LIMIT 10 |
| Code Block | ||
|---|---|---|
| ||
s := "SELECT * FROM `user` WHERE `status` IN(?)" m, _ := g.ModelRaw(s, g.Slice{1,2,3}).WhereLT("age", 18).Limit(10).OrderAsc("id").All() // SELECT * FROM `user` WHERE `status` IN(1,2,3) AND `age`<18 ORDER BY `id` ASC LIMIT 10 |
链式安全
链式安全只是模型操作的两种方式区别：一种会修改当前model对象（不安全，默认），一种不会（安全）但是模型属性修改/条件叠加需要使用赋值操作，仅此而已。
默认情况
在默认情况下，gdb是非链式安全的，也就是说链式操作的每一个方法都将对当前操作的Model属性进行修改，因此该Model对象不可以重复使用。例如，当存在多个分开查询的条件时，我们可以这么来使用Model对象：
| Code Block | ||
|---|---|---|
| ||
user := g |
.Model("user")
user.Where("status |
", g.Slice{1,2,3})
if vip {
// 查询条件自动叠加，修改当前模型对象
user.Where("money>=?", 1000000)
} else {
// 查询条件自动叠加，修改当前模型对象
user.Where("money<?", 1000000)
}
// vip: SELECT * FROM user WHERE status IN(1,2,3) AND money >= 1000000
// !vip: SELECT * FROM user WHERE status IN(1,2,3) AND money < 1000000
r, err := user.All()
// vip: SELECT COUNT(1) FROM user WHERE status IN(1,2,3) AND money >= 1000000
// !vip: SELECT COUNT(1) FROM user WHERE status IN(1,2,3) AND money < 1000000
n, err := user.Count() |
可以看到，如果是分开执行链式操作，链式的每一个操作都会修改已有的Model对象，查询条件会自动叠加，因此user对象不可重复使用，否则条件会不停叠加。并且在这种使用方式中，每次我们需要操作user用户表，都得使用g.DB().Table("user")这样的语法创建一个新的user模型对象，相对来说会比较繁琐。
| Tip |
|---|
默认情况下，基于性能以及GC优化考虑，模型对象为 |
不过需要注意的是，如果使用的是cli工具gen dao生成的dao，如user := dao.User.Ctx(ctx)，此时获取到的user Model 对象默认是链式安全的（已自动调用过.Safe()）。
Clone方法
此外，我们也可以手动调动Clone方法克隆当前模型，创建一个新的模型来实现链式安全，由于是新的模型对象，因此并不担心会修改已有的模型对象的问题。例如：
| Code Block | ||
|---|---|---|
| ||
// 定义一个用户模型单例
user := g |
.Model("user") |
| Code Block | ||
|---|---|---|
| ||
// 克隆一个新的用户模型
m := user.Clone()
m.Where("status |
", g.Slice{1,2,3})
if vip {
m. |
Where("money>=?", 1000000) } else { m. |
Where("money<?", 1000000) } // vip: SELECT * FROM user WHERE status IN(1,2,3) AND money >= 1000000 // !vip: SELECT * FROM user WHERE status IN(1,2,3) AND money < 1000000 r, err := m.All() // vip: SELECT COUNT(1) FROM user WHERE status IN(1,2,3) AND money >= 1000000 // !vip: SELECT COUNT(1) FROM user WHERE status IN(1,2,3) AND money < 1000000 n, err := m.Count() |
Safe方法
当然，我们可以通过Safe方法设置当前模型为链式安全的对象，后续的每一个链式操作都将返回一个新的Model对象，该Model对象可重复使用。但需要特别注意的是，模型属性的修改，或者操作条件的叠加，需要通过变量赋值的方式（m = m.xxx）覆盖原有的模型对象来实现。例如：
| Code Block | ||
|---|---|---|
| ||
// 定义一个用户模型单例
user := g |
.Model("user").Safe() |
| Code Block | ||
|---|---|---|
| ||
m := user.Where("status |
", g.Slice{1,2,3})
if vip {
// 查询条件通过赋值叠加
m = m. |
Where("money>=?", 1000000) } else { // 查询条件通过赋值叠加 m = m. |
Where("money<?", 1000000) } // vip: SELECT * FROM user WHERE status IN(1,2,3) AND money >= 1000000 // !vip: SELECT * FROM user WHERE status IN(1,2,3) AND money < 1000000 r, err := m.All() // vip: SELECT COUNT(1) FROM user WHERE status IN(1,2,3) AND money >= 1000000 // !vip: SELECT COUNT(1) FROM user WHERE status IN(1,2,3) AND money < 1000000 n, err := m.Count() |
可以看到，示例中的用户模型单例对象user可以重复使用，而不用担心被“污染”的问题。在这种链式安全的方式下，我们可以创建一个用户单例对象user，并且可以重复使用到后续的各种查询中。但是存在多个查询条件时，条件的叠加需要通过模型赋值操作（m = m.xxx）来实现。
| Tip |
|---|
使用 |
| Panel | ||
|---|---|---|
| ||
|