對(duì)象的 CRUD 操作

如果已知主鍵的值，那么可以使用這些方法進(jìn)行 CRUD 操作

對(duì) object 操作的四個(gè)方法 Read / Insert / Update / Delete

o := orm.NewOrm()
user := new(User)
user.Name = "slene"

fmt.Println(o.Insert(user))

user.Name = "Your"
fmt.Println(o.Update(user))
fmt.Println(o.Read(user))
fmt.Println(o.Delete(user))

如果需要通過(guò)條件查詢獲取對(duì)象，請(qǐng)參見(jiàn)高級(jí)查詢

Read

o := orm.NewOrm()
user := User{Id: 1}

err := o.Read(&user)

if err == orm.ErrNoRows {
    fmt.Println("查詢不到")
} else if err == orm.ErrMissPK {
    fmt.Println("找不到主鍵")
} else {
    fmt.Println(user.Id, user.Name)
}

Read 默認(rèn)通過(guò)查詢主鍵賦值，可以使用指定的字段進(jìn)行查詢：

user := User{Name: "slene"}
err = o.Read(&user, "Name")
...

對(duì)象的其他字段值將會(huì)是對(duì)應(yīng)類型的默認(rèn)值

復(fù)雜的單個(gè)對(duì)象查詢參見(jiàn) One

ReadOrCreate

嘗試從數(shù)據(jù)庫(kù)讀取，不存在的話就創(chuàng)建一個(gè)

默認(rèn)必須傳入一個(gè)參數(shù)作為條件字段，同時(shí)也支持多個(gè)參數(shù)多個(gè)條件字段

o := orm.NewOrm()
user := User{Name: "slene"}
// 三個(gè)返回參數(shù)依次為：是否新創(chuàng)建的，對(duì)象 Id 值，錯(cuò)誤
if created, id, err := o.ReadOrCreate(&user, "Name"); err == nil {
    if created {
        fmt.Println("New Insert an object. Id:", id)
    } else {
        fmt.Println("Get an object. Id:", id)
    }
}

Insert

第一個(gè)返回值為自增健 Id 的值

o := orm.NewOrm()
var user User
user.Name = "slene"
user.IsActive = true

id, err := o.Insert(&user)
if err == nil {
    fmt.Println(id)
}

創(chuàng)建后會(huì)自動(dòng)對(duì) auto 的 field 賦值

InsertMulti

同時(shí)插入多個(gè)對(duì)象

類似sql語(yǔ)句

insert into table (name, age) values("slene", 28),("astaxie", 30),("unknown", 20)

第一個(gè)參數(shù) bulk 為并列插入的數(shù)量，第二個(gè)為對(duì)象的slice

返回值為成功插入的數(shù)量

users := []User{
    {Name: "slene"},
    {Name: "astaxie"},
    {Name: "unknown"},
    ...
}
successNums, err := o.InsertMulti(100, users)

bulk 為 1 時(shí)，將會(huì)順序插入 slice 中的數(shù)據(jù)

Update

第一個(gè)返回值為影響的行數(shù)

o := orm.NewOrm()
user := User{Id: 1}
if o.Read(&user) == nil {
    user.Name = "MyName"
    if num, err := o.Update(&user); err == nil {
        fmt.Println(num)
    }
}

Update 默認(rèn)更新所有的字段，可以更新指定的字段：

// 只更新 Name
o.Update(&user, "Name")
// 指定多個(gè)字段
// o.Update(&user, "Field1", "Field2", ...)
...

根據(jù)復(fù)雜條件更新字段值參見(jiàn) Update

Delete

第一個(gè)返回值為影響的行數(shù)

o := orm.NewOrm()
if num, err := o.Delete(&User{Id: 1}); err == nil {
    fmt.Println(num)
}

Delete 操作會(huì)對(duì)反向關(guān)系進(jìn)行操作，此例中 Post 擁有一個(gè)到 User 的外鍵。刪除 User 的時(shí)候。如果 on_delete 設(shè)置為默認(rèn)的級(jí)聯(lián)操作，將刪除對(duì)應(yīng)的 Post

Changed in 1.0.3 刪除以后不會(huì)刪除 auto field 的值