go中的tag在结构体中使用的。有两个作用:
(1)给结构体属性起别名,字段映射。对于不同类型的类型对应不同的值,比如xml,yaml,json等分别对应着不同的区域,当然标签也不同。比如json,bson,都是约定俗成的了。
(2)做属性判断和验证。
1.tag中的格式
(1)tag本身是一个字符串,字符串整个使用反引号``。
(2)key必须是非空字符串,不能使用双引号。字符串不能包含控制字符,空格,引号,冒号。
(3)value以双引号标记的字符串。
(4)多个标签之间使用空格连接,标签名不需要使用双引号,标签名对应的值需要使用双引号,多个标签值需要使用逗号连接。
举例:
type User struct {
UserId int `json:"user_id" bson:"b_user_id,bson_id"`
UserName string `json:"user_name" bson:"b_user_name"`
}
注意:冒号前后不能有空格。
比如以下几个就是约定俗成的标签:bson,json,yaml,xml等,当然这个标签是可以自定义的
2.json,bson标签
type User struct {
ID string `json:"id,omitempty" bson:"_id,omitempty"`
Username string `json:"username,omitempty" bson:"username,omitempty"`
Email string `json:"email,omitempty" bson:"email,omitempty"`
}
比如以上代码,标签是为了起别名,只是每个标签作用的地方不一样。比如json前后端交互的时候用的多,比如请求和响应的都是json格式的数据。bson在和mongoDB数据库交互的时候使用的多。
json标签:使用了json标签,用于指定字段在json编码中的名称和行为,在与前端进行数据交互时,使用json标签可以确保字段在序列化为 JSON 数据时具有正确的名称和行为。
bson标签:使用了bson标签,bson标签是用于指定字段在 MongoDB 数据库中的名称和行为。当使用 MongoDB 数据库进行数据存储时,使用 bson标签可以确保字段在序列化和反序列化 BSON(Binary JSON)数据时具有正确的名称和行为。
通过这些标签为字段起别名,可以在前端和数据库端建立字段映射,确保数据正确的传递和存储。
1. JSON 标签( json ):
- 在结构体字段上使用 json:"field_name" 标签,可以指定字段在 JSON 编码和解码中的别名和选项。
- 例如: UserName string json:"user_name"
- 这样的标签可以指定在 JSON 编码和解码中使用 "user_name" 作为字段的别名。
2. BSON 标签( bson ):
- 在结构体字段上使用 bson:"field_name" 标签,可以指定字段在 BSON 编码和解码中的别名和选项。
- 例如: UserName string bson:"b_user_name"
- 这样的标签可以指定在 BSON 编码和解码中使用 "b_user_name" 作为字段的别名。
3. YAML 标签( yaml ):
- 在结构体字段上使用 yaml:"field_name" 标签,可以指定字段在 YAML 编码和解码中的别名和选项。
- 例如: UserName string yaml:"user_name"
- 这样的标签可以指定在 YAML 编码和解码中使用 "user_name" 作为字段的别名。
4. XML 标签( xml ):
- 在结构体字段上使用 xml:"field_name" 标签,可以指定字段在 XML 编码和解码中的别名和选项。
- 例如: UserName string xml:"user_name"
- 这样的标签可以指定在 XML 编码和解码中使用 "user_name" 作为字段的别名。
需要注意的是,这些标签的具体含义和使用方式可能因使用的库或工具而有所不同。这些示例展示了在 Go 语言中使用不同标签的一般用法,但具体的实现可能会因库或工具的不同而有所区别。
至于 YAML 和 XML 文件的读取,可以使用相应的库进行解析和处理。对于 YAML 文件,可以使用 gopkg.in/yaml.v2 包,对于 XML 文件,可以使用 encoding/xml 包或其他第三方包进行解析和处理。
3.举例
其实自己也可以想例子,以下案例作参考。
type Student struct {
// 返回给前端的话,首字母大写很奇怪,所以给Name起了个别名
Name string `json:"name"`
Age int
}
func testTag() {
s1 := Student{
Name: "s1k",
}
bytes, err := json.Marshal(s1)
if err != nil {
panic(err)
}
// 将[]byte数组转换为string类型json类型
//s := string(bytes)
var s Student
json.Unmarshal(bytes, &s)
fmt.Printf("%v", s)
}
type User struct {
UserId int `json:"user_id" bson:"b_user_id"`
UserName string `json:"user_name" bson:"b_user_name"`
}
func testJson() {
u := &User{
UserId: 1,
UserName: "tony",
}
fmt.Printf("%T", u)
bytes, _ := json.Marshal(u)
fmt.Println(string(bytes))
// 通过反射获取标签的值
// reflect.TypeOf(u),获取的是指针类型
types := reflect.TypeOf(u)
field := types.Elem().Field(0)
fmt.Println(field.Tag.Get("json"))
fmt.Println(field.Tag.Get("bson"))
}
type Http struct {
Port string `yaml:"port"`
Secret string `yaml:"secretKey"`
Domain string `yaml:"domain"`
}
type Config struct {
Http `yaml:"http"`
}
func testYaml() {
//var h Http
config := new(Config)
file, err := ioutil.ReadFile("config.yaml")
if err != nil {
fmt.Println(err.Error())
}
// 将解析后的数据存储到结构体中
err = yaml.Unmarshal(file, config)
if err != nil {
fmt.Println(err.Error())
}
fmt.Println(config.Http, " ", config.Port, " ", config.Secret, " ", config.Domain)
}
type Person struct {
Name string `json:"name"`
Age string `json:"age,omitempty"` //有 omitempty 属性,因此 encoding/json 在将对象转化 json 字符串时,
// 只要发现对象里的 Addr 为 false, 0, 空指针,空接口,空数组,空切片,空映射,空字符串中的一种,就会被忽略。
}
func testTags() {
p1 := &Person{
Name: "zhangsan",
}
// 所以空字符串就会被忽略
bytes, _ := json.Marshal(p1)
fmt.Printf("%s", bytes)
fmt.Println(p1)
fmt.Printf("%T", p1)
p2 := &Person{
Name: "lisi",
Age: "15",
}
fmt.Println(p2)
}
// 从结构体中取出tag,通过反射
/*
获取字段 field
获取标签 tag
获取键值对 key:value
// 三种获取 field
field := reflect.TypeOf(obj).FieldByName("Name")
field := reflect.ValueOf(obj).Type().Field(i) // i 表示第几个字段
field := reflect.ValueOf(&obj).Elem().Type().Field(i) // i 表示第几个字段
// 获取 Tag
tag := field.Tag
// 获取键值对
labelValue := tag.Get("label")
labelValue,ok := tag.Lookup("label")
*/
func getTag() {
p2 := &Person{
Name: "lisi",
Age: "15",
}
// 三种方式获取Field
field := reflect.ValueOf(p2).Elem().Type().Field(1)
getName := field.Tag.Get("json")
// 获取tag
//value, ok := tag.Lookup("name")
fmt.Println(getName)
}