name: CRUD 操作

sort: 3

对象的 CRUD 操作

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

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

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

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

Read

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

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
  5. id, err := o.Insert(&user)
  6. if err == nil {
  7. fmt.Println(id)
  8. }

创建后会自动对 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 的值