• 对象的 CRUD 操作
    • Read
    • ReadOrCreate
    • Insert
    • InsertMulti
    • Update
    • Delete

    对象的 CRUD 操作

    如果已知主键的值，那么可以使用这些方法进行 CRUD 操作

    对 object 操作的四个方法 Read / Insert / Update / Delete

    1. o := orm.NewOrm()
    2. user := new(User)
    3. user.Name = "slene"
    5. fmt.Println(o.Insert(user))
    7. user.Name = "Your"
    8. fmt.Println(o.Update(user))
    9. fmt.Println(o.Read(user))
    10. fmt.Println(o.Delete(user))

    如果需要通过条件查询获取对象，请参见高级查询

    Read

    1. o := orm.NewOrm()
    2. user := User{Id: 1}
    4. err := o.Read(&user)
    6. if err == orm.ErrNoRows {
    7.     fmt.Println("查询不到")
    8. } else if err == orm.ErrMissPK {
    9.     fmt.Println("找不到主键")
    10. } else {
    11.     fmt.Println(user.Id, user.Name)
    12. }

    Read 默认通过查询主键赋值，可以使用指定的字段进行查询：

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

    对象的其他字段值将会是对应类型的默认值

    复杂的单个对象查询参见 One

    ReadOrCreate

    尝试从数据库读取，不存在的话就创建一个

    默认必须传入一个参数作为条件字段，同时也支持多个参数多个条件字段

    1. o := orm.NewOrm()
    2. user := User{Name: "slene"}
    3. // 三个返回参数依次为：是否新创建的，对象 Id 值，错误
    4. if created, id, err := o.ReadOrCreate(&user, "Name"); err == nil {
    5.     if created {
    6.         fmt.Println("New Insert an object. Id:", id)
    7.     } else {
    8.         fmt.Println("Get an object. Id:", id)
    9.     }
    10. }

    Insert

    第一个返回值为自增健 Id 的值

    1. o := orm.NewOrm()
    2. var user User
    3. user.Name = "slene"
    4. user.IsActive = true
    6. id, err := o.Insert(&user)
    7. if err == nil {
    8.     fmt.Println(id)
    9. }

    创建后会自动对 auto 的 field 赋值

    InsertMulti

    同时插入多个对象

    类似sql语句

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

    第一个参数 bulk 为并列插入的数量，第二个为对象的slice

    返回值为成功插入的数量

    1. users := []User{
    2.     {Name: "slene"},
    3.     {Name: "astaxie"},
    4.     {Name: "unknown"},
    5.     ...
    6. }
    7. successNums, err := o.InsertMulti(100, users)

    bulk 为 1 时，将会顺序插入 slice 中的数据

    Update

    第一个返回值为影响的行数

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

    Update 默认更新所有的字段，可以更新指定的字段：

    1. // 只更新 Name
    2. o.Update(&user, "Name")
    3. // 指定多个字段
    4. // o.Update(&user, "Field1", "Field2", ...)
    5. ...

    根据复杂条件更新字段值参见 Update

    Delete

    第一个返回值为影响的行数

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

    Delete 操作会对反向关系进行操作，此例中 Post 拥有一个到 User 的外键。删除 User 的时候。如果 on_delete 设置为默认的级联操作，将删除对应的 Post

    Changed in 1.0.3 删除以后不会删除 auto field 的值