1. 创建

1.1. 创建记录

  1. user := User{Name: "Jinzhu", Age: 18, Birthday: time.Now()}
  2. db.NewRecord(user) // => 返回 `true` ,因为主键为空
  3. db.Create(&user)
  4. db.NewRecord(user) // => 在 `user` 之后创建返回 `false`

1.2. 默认值

你可以通过标签定义字段的默认值,例如:

  1. type Animal struct {
  2. ID int64
  3. Name string `gorm:"default:'galeone'"`
  4. Age int64
  5. }

然后 SQL 会排除那些没有值或者有 零值 的字段,在记录插入数据库之后,gorm将从数据库中加载这些字段的值。

  1. var animal = Animal{Age: 99, Name: ""}
  2. db.Create(&animal)
  3. // INSERT INTO animals("age") values('99');
  4. // SELECT name from animals WHERE ID=111; // 返回的主键是 111
  5. // animal.Name => 'galeone'

注意 所有包含零值的字段,像 0''false 或者其他的 零值 不会被保存到数据库中,但会使用这个字段的默认值。你应该考虑使用指针类型或者其他的值来避免这种情况:

  1. // Use pointer value
  2. type User struct {
  3. gorm.Model
  4. Name string
  5. Age *int `gorm:"default:18"`
  6. }
  7. // Use scanner/valuer
  8. type User struct {
  9. gorm.Model
  10. Name string
  11. Age sql.NullInt64 `gorm:"default:18"`
  12. }

1.3. 在钩子中设置字段值

如果你想在 BeforeCreate 函数中更新字段的值,应该使用 scope.SetColumn,例如:

  1. func (user *User) BeforeCreate(scope *gorm.Scope) error {
  2. scope.SetColumn("ID", uuid.New())
  3. return nil
  4. }

1.4. 创建额外选项

  1. // 为插入 SQL 语句添加额外选项
  2. db.Set("gorm:insert_option", "ON CONFLICT").Create(&product)
  3. // INSERT INTO products (name, code) VALUES ("name", "code") ON CONFLICT;