gorm声明模型

模型定义

　　模型是标准的结构体，由go的基本数据类型、实现了Scanner和Valuer接口的自定义类型及其指针或别名组成

例如：

type User struct {

	ID uint

	Name string

	Email *string

	Age uint8

	Birthday *time.Time

	MemberNumber sql.NullString  // 结构体类型实现了Scanner接口和Valuer接口

	ActivatedAt sql.NullTime

	CreatedAt time.Time

	UpdatedAt time.Time

}

约定

GORM 倾向于约定，而不是配置。默认情况下，GORM 使用 ID 作为主键，使用结构体名的 蛇形复数 作为表名，字段名的 蛇形 作为列名，并使用 CreatedAt、UpdatedAt 字段追踪创建、更新时间

遵循 GORM 已有的约定，可以减少您的配置和代码量。

gorm.Model

GORM 定义一个 gorm.Model 结构体，其包括字段 ID、CreatedAt、UpdatedAt、DeletedAt

// gorm.Model 的定义

type Model struct {

  ID        uint           `gorm:"primaryKey"`

  CreatedAt time.Time

  UpdatedAt time.Time

  DeletedAt gorm.DeletedAt `gorm:"index"`

}

　　您可以将它嵌入到您的结构体中，以包含这几个字段，详情请参考嵌入结构体

字段级权限控制

可导出的字段在使用 GORM 进行 CRUD 时拥有全部的权限，此外，GORM 允许您用标签控制字段级别的权限。这样您就可以让一个字段的权限是只读、只写、只创建、只更新或者被忽略

注意： 使用 GORM Migrator 创建表时，不会创建被忽略的字段

type User struct {

  Name string `gorm:"<-:create"` // 允许读和创建

  Name string `gorm:"<-:update"` // 允许读和更新

  Name string `gorm:"<-"`        // 允许读和写（创建和更新）

  Name string `gorm:"<-:false"`  // 允许读，禁止写

  Name string `gorm:"->"`        // 只读（除非有自定义配置，否则禁止写）

  Name string `gorm:"->;<-:create"` // 允许读和写

  Name string `gorm:"->:false;<-:create"` // 仅创建（禁止从 db 读）

  Name string `gorm:"-"`  // 通过 struct 读写会忽略该字段

}

自定义基础模型：ID、Created、Updated、Deleted

type BaseModel struct {

	ID        uint `gorm:"primarykey"`

	Created time.Time `gorm:"autoCreateTime"`

	Updated time.Time `gorm:"autoUpdateTime"`

	Deleted gorm.DeletedAt `gorm:"index"`

}

对于正常的结构体字段，你也可以通过标签 embedded 将其嵌入,并且，您可以使用标签 embeddedPrefix 来为 db 中的字段名添加前缀，例如：

type Author struct {

	Address string

}

type User struct {

	BaseModel

	Author Author `gorm:"embedded;embeddedPrefix:author_"`

	Name string

	Age uint8

}

字段标签

声明 model 时，tag 是可选的，GORM 支持以下 tag： tag 名大小写不敏感，但建议使用 camelCase 风格

标签名	说明
column	指定 db 列名
type	列数据类型，推荐使用兼容性好的通用类型，例如：所有数据库都支持 bool、int、uint、float、string、time、bytes 并且可以和其他标签一起使用，例如：`not null`、`size`, `autoIncrement`… 像 `varbinary(8)` 这样指定数据库数据类型也是支持的。在使用指定数据库数据类型时，它需要是完整的数据库数据类型，如：`MEDIUMINT UNSIGNED not NULL AUTO_INCREMENT`
size	指定列大小，例如：`size:256`
primaryKey	指定列为主键
unique	指定列为唯一
default	指定列的默认值
precision	指定列的精度
scale	指定列大小
not null	指定列为 NOT NULL
autoIncrement	指定列为自动增长
autoIncrementIncrement	自动步长，控制连续记录之间的间隔
embedded	嵌套字段
embeddedPrefix	嵌入字段的列名前缀
autoCreateTime	创建时追踪当前时间，对于 `int` 字段，它会追踪秒级时间戳，您可以使用 `nano`/`milli` 来追踪纳秒、毫秒时间戳，例如：`autoCreateTime:nano`
autoUpdateTime	创建/更新时追踪当前时间，对于 `int` 字段，它会追踪秒级时间戳，您可以使用 `nano`/`milli` 来追踪纳秒、毫秒时间戳，例如：`autoUpdateTime:milli`
index	根据参数创建索引，多个字段使用相同的名称则创建复合索引，查看索引获取详情
uniqueIndex	与 `index` 相同，但创建的是唯一索引
check	创建检查约束，例如 `check:age > 13`，查看约束获取详情
<-	设置字段写入的权限， `<-:create` 只创建、`<-:update` 只更新、`<-:false` 无写入权限、`<-` 创建和更新权限
->	设置字段读的权限，`->:false` 无读权限
-	忽略该字段，`-` 无读写权限
comment	迁移时为字段添加注释