Golang

关注公众号 jb51net

关闭
首页 > 脚本专栏 > Golang > go struct标签

go语言中struct标签详解

作者:勤天

这篇文章主要给大家介绍了关于go语言中struct标签的相关资料,文中通过实例代码介绍的非常详细,对大家学习或者使用go语言具有一定的参考学习价值,需要的朋友可以参考下

一、结构体标签介绍

结构体的字段除了名字和类型外,还可以有一个可选的标签(tag):它是一个附属于字段的字符串,可以是文档或其他的重要标记。

Tag是结构体在编译阶段关联到成员的元信息字符串,在运行的时候通过反射的机制读取出来。

结构体标签由一个或多个键值对组成。键与值使用冒号分隔,值用双引号括起来。键值对之间使用一个空格分隔

`key1:"value1" key2:"value2" key3:"value3"...`  // 键值对用空格分隔

注意:冒号左右不能有空格,否则运行输出结果可能不对,所以,编写 Tag 时,必须严格遵守键值对的规则。结构体标签的解析代码的容错能力很差,一旦格式写错,编译和运行时都不会提示任何错误

key会指定反射的解析方式包含 :json(JSON标签)、 orm(Beego标签)、gorm(GORM标签)、bson(MongoDB标签)、form(表单标签)、binding(表单验证标签).

这些系统使用标签设定字段在处理时应该具备的特殊属性和可能发生的行为。这些信息都是静态的,无须实例化结构体,可以通过反射获取到。

二、json标签

将Go语言中结构体slice转为JSON的过程叫编组(marshaling),编组通过json.Marshal函数完成

json.Unmarshal()可以把json字符串转换为结构体,在很多第三方包方法都会读取结构体标签。

type User struct {
	Name string `json:"username"` // 编码后的字段名为 username
	Age  int    `json:"userage"`  // 编码后的字段名为 userage
    Sex  string // 编码后的字段名为 Sex
    Hobby string    `json:"-"` // 字段不进行序列化
}
 
func main() {
	u1 := User{"zhangsan", 20, "男", "eat"}
	jsondata1, err := json.Marshal(u1)
 
	if err != nil {
		fmt.Println("格式错误")
	} else {
		fmt.Printf("User结构体转json:%s\n", jsondata)
	}
 
//输出
User结构体转json:{"username":"zhangsan","userage":20,"Sex":"男"}

标签选项

使用说明

-

字段不进行序列化 例:json:"-"

omitempy

类型零值或空值,序列化时忽略该字段 例:json:",omitempy" 字段名省略的话用结构体字段名

Type

重新指定字段类型 例:json:"age,string"

三、gorm标签

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

GORM 默认定义一个 gorm.Model 结构体,其包括字段 ID、CreatedAt、UpdatedAt、DeletedAt,可以嵌套入自建结构体,tag名大小写不敏感,建议使用camelCase风格,多个标签定义用分号(;)分隔:

// gorm.Model 的定义
type Model struct {
  ID        uint           `gorm:"primaryKey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
}

示例:

type AddUserAuth struct {
	gorm.BaseModel
	UUID        string `gorm:"column:user_uuid;comment:用户UUID;type:varchar(100);"`        // 用户UUID
	User        string `gorm:"column:user_name;comment:用户名称;type:varchar(50);"`           // 用户登录名
	Cluster     string `gorm:"column:cluster_name;comment:集群名称;type:varchar(50);"`     // k8s集群
	NameSpace   string `gorm:"column:namespace;comment:命名空间;type:varchar(50);"`      // 命名空间
	ServiceName string ` gorm:"column:service_name;comment:应用名称;type:varchar(50);"` // 应用名称
	ServiceType string `gorm:"column:service_type;comment:应用类型;type:varchar(50);"` // 应用类型
}

生成的建表语句如下:

CREATE TABLE `add_user_auths` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `created_at` datetime DEFAULT NULL,
  `updated_at` datetime DEFAULT NULL,
  `deleted_at` datetime DEFAULT NULL,
  `user_uuid` varchar(100) DEFAULT NULL COMMENT '用户UUID',
  `user_name` varchar(50) DEFAULT NULL COMMENT '用户名称',
  `cluster_name` varchar(50) DEFAULT NULL COMMENT '集群名称',
  `namespace` varchar(50) DEFAULT NULL COMMENT '命名空间',
  `service_name` varchar(50) DEFAULT NULL COMMENT '应用名称',
  `service_type` varchar(50) DEFAULT NULL COMMENT '应用类型',
  PRIMARY KEY (`id`),
  KEY `idx_add_user_auths_deleted_at` (`deleted_at`)
) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=utf8mb4

使用 GORM Migrator 创建表时,不会创建被忽略的字段。

如果想要保存 UNIX(毫/纳)秒时间戳,而不是 time,只需简单地将 time.Time 修改为 int 即可。

字段标签:

声明 model 时,tag 是可选的,GORM 支持以下 tag:

标签名

说明

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

迁移时为字段添加注释

关联标签:

GORM 允许通过标签为关联配置外键、约束、many2many 表:

标签名

说明

foreignKey

指定当前模型的列作为连接表的外键

references

指定引用表的列名,其将被映射为连接表外键

polymorphic

指定多态类型,比如模型名

polymorphicValue

指定多态值、默认表名

many2many

指定连接表表名

joinForeignKey

指定连接表的外键列名,其将被映射到当前表

joinReferences

指定连接表的外键列名,其将被映射到引用表

constraint

关系约束,例如:OnUpdate、OnDelete

四、form标签

Gin中提供了模型绑定,将表单数据和模型进行绑定,方便参数校验和使用。

模型绑定:

// 表单数据
type LoginForm struct {
    UserName  string    `form:"username"`    
    Password  string    `form:"password"`
    Email	  string    `form:"email"`  
}
// model 或 service 层Model
type Email struct {
    Email       string
    Password    string
}
 
 
func EmailLogin (c *gin.Context) {
    var email LoginForm
    if err := c.ShouldBind(&email); err != nil {
        ...
    }
    // 获取表单数据局
    args := Email {
        Email:     email.Email,
        Password:  email.Password,
    }
    // 对参数进行后续使用
    ...
}

通过 form:"email" 对表单email数据进行绑定。然后通过Bind()、ShouldBind()等方法获取参数值。

五、binding标签

Gin 主要提供了两组绑定方法 Must bind 与 Should bind 。gin/binding 内置模型绑定实现,将请求数据提取到合适的绑定器。

Must bind:验证不通过,就会被终止或抛出特定的错误页面

Should bind:存在绑定错误,这个错误会被返回,需要自行处理相应的请求和错误。

Gin 框架本身已经实现了多种绑定,通常用来绑定来自请求数据,有不同的结构体实例与之对应。其实现的绑定有 JSON, XML, Form,Query,FormPost,FormMultipart,ProtoBuf,MsgPack,YAML,Uri。

Gin对于数据的校验使用的是 validator.v10 包,该包提供多种数据校验方法,通过binding:""标签来进行数据校验。

校验规则见github:validator

示例:

type LoginForm struct {
    Email     string    `form:"email" binding:"email"`    
    UserName  string    `form:"username" binding:"username"`    
    Password  string    `form:"password" binging:"required,min=6,max=10"`
}

特殊符号:

符号

说明

,

分隔多个标签选项,逗号之间不能有空格

-

该字段不做校验

|

使用多个选项,满足其中一个即可

必须校验

标签选项

说明

示例

required

表示该字段值必输设置,且不能为默认值

binding:required

omitempty

如果字段未设置,则忽略它

binding:reqomitemptyuired

字符串校验

标签选项

使用说明

示例

contains

参数值包含设置子串

binding:"contains=ares"是否包含ares字符串

excludes

参数值不包含设置子串

binding:"excludes=ares"是否不包含ares字符串

startswith

字符串前缀

binding:"startswith=ares"是否以tom开头

endswith

字符串前缀

binding:"endswith=ares"是否以tom结尾

范围校验

范围验证: 切片、数组和map、字符串,验证其长度;数值,验证大小范围。

标签选项

使用说明

示例

len

参数值等于给定值

binding:"len=3"等于3

ne

不等于

binding:"ne=3"不等于3

max

最大值,小于等于参数值

binding:"max=3"小于等于3

min

最小值,大于等于参数值

binding:"min=3"大于等于3

lte

参数值小于等于给定值

binding:"lte=3"小于等于3

gte

参数值大于等于给定值

binding:"gte=3"大于等于3

lt

参数值小于给定值

binding:"lt=3"小于3

gt

参数值大于给定值

binding:"gt=3"大于3

oneof

参数值只能是枚举值中的一个,值必须是数值或字符串,以空格分隔,如果字符串中有空格,将字符串用单引号包围

binding:"oneof=red green"

字段校验

标签选项

使用说明

eqcsfield

跨不同结构体字段相等,比如struct1 field1 是否等于struct2 field2

necsfield

跨不同结构体字段不相等

eqfield

同一结构体字段相等验证,例如:输入两次密码

nefield

同一结构体字段不相等验证

gtefield

大于等于同一结构体字段

ltefield

小于等于同一结构体字段

示例:

// 不同结构体校验
type S1 struct { 
    F1 string `validate:eqcsfield=S2.F2` 
    S2 struct { 
        F2 string 
    } 
}
// 同一结构体字段相同校验
type Email struct { 
    Email  string `validate:"lte=4"` 
    Pwd    string `validate:"min=10"` 
    Pwd2   string `validate:"eqfield=Pwd"`
}
// 同一结构体字段不相等
type User struct { 
    Name     string `validate:"lte=4"` 
    Age      int `validate:"min=20"` 
    Password string `validate:"min=10,nefield=Name"`
}

其他校验

标签选项

使用说明

示例

ip

合法IP地址校验

binding:"ip"

email

合法邮箱校验

binding:"email"

url

合法的URL

binding:"url"

uri

合法的URI

binding:"uri"

uuid

uuid验证

binding:"uuid"

datetime

合法时间格式值校验

binding:"datetime=2006-01-02"

json

JSON数据验证

validate:"json"

numeric

数值验证 正则:^[-+]?[0-9]+(?:\\.[0-9]+)?$

validate:"numeric"

number

整数验证 正则:^[0-9]+$

validate:"number"

alpha

字母字符串验证 正则:^[a-zA-Z]+$

validate:"alpha"

alphanum

字母数字字符串验证 正则:^[a-zA-Z0-9]+$

validate:"alphanum"

ascii

Ascii 字符验证

validate:"ascii"

六、ini标签

ini 是 Windows 上常用的配置文件格式, go-ini是 Go 语言中用于操作 ini 文件的第三方库。

若使用ini格式配置,需要将配置文件字段映射到结构体变量,如果键名与字段名不相同,那么需要在结构标签中指定对应的键名。标准库encoding/json、encoding/xml解析时可以将键名直接对应到字段名,而go-ini库不可以,所以需要在结构体标签指定对应键名。

## 配置文件 cnf.ini
user_name  = ares
age = 20
// 配置文件映射 结构体
type Config struct {
  UserName   string `ini:"user_name"`  // ini标签指定下键名
  Age  string `ini:"age"`
}

总结

到此这篇关于go语言中struct标签的文章就介绍到这了,更多相关go struct标签内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:
阅读全文