详解golang中的结构体编解码神器Mapstructure库

更新时间：2023年09月19日 09:40:34 作者：奈何碎银没有几两

mapstructure是GO字典(map[string]interface{})和Go结构体之间转换的编解码工具,这篇文章主要为大家介绍一下Mapstructure库的相关使用,希望对大家有所帮助

一：介绍

简言之： mapstructure是GO字典(map[string]interface{})和Go结构体之间转换的编解码工具。

核心方法：mapstructure.Decode(input interface{}, output interface{})

二：安装

go get github.com/mitchellh/mapstructure

源码地址：https://github.com/mitchellh/mapstructure

官方文档地址：https://pkg.go.dev/github.com/mitchellh/mapstructure

三：使用

3.1: 简单使用案例

案例：将一个JSON字符串解析为字典对象，然后把字典绑定到一个结构体对象中。

package main
import (
	"encoding/json"
	"fmt"
	"github.com/mitchellh/mapstructure"
	"log"
)
type Person struct {
	Name string
	Age  int
	Job  string
}
func main() {
	// 定义一个JSON字符串
	dataJson :=
		`{
		  "name":"renshanwen",
		  "age":18,
		  "job": "engineer"
		}`
	// 将JOSN字符串解析成字典
	var m map[string]interface{}
	err := json.Unmarshal([]byte(dataJson), &m)
	if err != nil {
		log.Fatal(err)
	}
	// 将结构体m，绑定到结构体对象p中
	var p Person
	mapstructure.Decode(m, &p)
	fmt.Printf("name is %s, age is %d, job is %s.", p.Name, p.Age, p.Job)
}

输出结果：

name is renshanwen, age is 18, job is engineer.

3.2: 字段标签

字段标签作用：定义Go字典和GO结构体字段映射关系。

默认：mapstructure使用结构体中字段的名称(大小写不敏感)做这个映射，

案例：例如我们的结构体有一个Name字段，mapstructure解码时会在map[string]interface{}中查找键名name。

指定关系映射：

package main
import (
	"encoding/json"
	"fmt"
	"github.com/mitchellh/mapstructure"
	"log"
)
type Person struct {
	Name string `mapstructure:"user_name"`
	Age  int    `mapstructure:"user_age"`
	Job  string `mapstructure:"user_job"`
}
func main() {
	// 定义一个JSON字符串
	dataJson :=
		`{
		  "user_name":"renshanwen",
		  "user_age":18,
		  "user_job": "engineer"
		}`
	// 将JOSN字符串解析成结构体
	var m map[string]interface{}
	err := json.Unmarshal([]byte(dataJson), &m)
	if err != nil {
		log.Fatal(err)
	}
	// 将结构体m，绑定到结构体对象p中
	var p Person
	mapstructure.Decode(m, &p)
	fmt.Printf("name is %s, age is %d, job is %s.", p.Name, p.Age, p.Job)
}

3.3: 结构体嵌套

如果入参JSON结构比较复杂，可以定义多重结构体， mapstructure会自动帮助我们解析。

package main
import (
	"encoding/json"
	"fmt"
	"github.com/mitchellh/mapstructure"
	"log"
)
type Person struct {
	Name string `mapstructure:"user_name"`
	Age  int    `mapstructure:"user_age"`
	Job  string `mapstructure:"user_job"`
}
// Worker 结构体嵌套
type Worker struct {
	Person Person
	Work   string `mapstructure:"user_work"`
}
func main() {
	// 定义一个JSON字符串
	dataJson := `{
					"person":{
						"user_name":"renshanwen",
						"user_age":18,
						"user_job":"engineer"
					},
					"user_work":"code"
				}`
	// 将JOSN字符串解析成结构体
	var m map[string]interface{}
	err := json.Unmarshal([]byte(dataJson), &m)
	if err != nil {
		log.Fatal(err)
	}
	// 将结构体m，绑定到结构体对象w中
	var w Worker
	mapstructure.Decode(m, &w)
	fmt.Printf("name is %s, age is %d, job is %s ,work is %s.", w.Person.Name, w.Person.Age, w.Person.Job, w.Work)
}

3.4: 统一存储未映射的值

可以定义一个字段，接收全部没有映射的字段。

案例：

package main
import (
	"encoding/json"
	"fmt"
	"github.com/mitchellh/mapstructure"
	"log"
)
type Person struct {
	Name string `mapstructure:"user_name"`
	Age  int    `mapstructure:"user_age"`
	Job  string `mapstructure:"user_job"`
}
// Worker 结构体嵌套
type Worker struct {
	Person Person
	Work   string                 `mapstructure:"user_work"`
	Other  map[string]interface{} `mapstructure:",remain"` // 未解析字段默认分配到这里
}
func main() {
	// 定义一个JSON字符串
	dataJson := `{
					"person":{
						"user_name":"renshanwen",
						"user_age":18,
						"user_job":"engineer"
					},
					"user_work":"code",
					"user_mather": "mather",
					"user_baby": "baby"
				}`
	// 将JOSN字符串解析成结构体
	var m map[string]interface{}
	err := json.Unmarshal([]byte(dataJson), &m)
	if err != nil {
		log.Fatal(err)
	}
	// 将结构体m，绑定到结构体对象w中
	var w Worker
	mapstructure.Decode(m, &w)
	fmt.Printf("name is %s, age is %d, job is %s ,work is %s other is %s.", w.Person.Name, w.Person.Age, w.Person.Job, w.Work, w.Other)
}

结果：

name is renshanwen, age is 18, job is engineer ,work is code other is map[user_baby:baby user_mather:mather].

3.5: 逆向转换

结构体—>字典

在反向解码时，我们可以为某些字段设置mapstructure:“,omitempty”。这样当这些字段为默认值时，就不会出现在结构的map[string]interface{}。

package main
import (
	"encoding/json"
	"fmt"
	"github.com/mitchellh/mapstructure"
)
type Person struct {
	Name string `mapstructure:"user_name"`
	Age  int    `mapstructure:"user_age"`
	Job  string `mapstructure:"user_job,omitempty"` // ,omitempty表示如果结构体对象没有，则不会解析到字典中。
}
// Worker 结构体嵌套
type Worker struct {
	Person Person
	Work   string                 `mapstructure:"user_work"`
	Other  map[string]interface{} `mapstructure:",remain"` // 未解析字段默认分配到这里
}
func main() {
	// 定义一个JSON字符串
	worker := &Worker{
		Work: "code",
	}
	worker.Person.Name = "renshanwen"
	worker.Person.Age = 18
	var m map[string]interface{}
	mapstructure.Decode(worker, &m)
	data, _ := json.Marshal(m)
	fmt.Println(string(data))
	// {"Other":null,"Person":{"user_age":18,"user_name":"renshanwen"},"user_work":"code"}
}

3.6: 收集绑定信息

可以使用mapstructure.Metadata, 存储绑定信息情况。

Keys：绑定成功的

Unused：没有绑定上的

Unset：缺失的

package main
import (
	"fmt"
	"github.com/mitchellh/mapstructure"
)
type Person struct {
	Name string `mapstructure:"user_name"`
	Age  int    `mapstructure:"user_age"`
	Job  string `mapstructure:"user_job,omitempty"` // ,omitempty表示如果结构体对象没有，则不会解析到字典中。
}
func main() {
	m := map[string]interface{}{
		"user_name": "renshanwen",
		"age":       18,
		"job":       "engineer",
	}
	var p Person
	var metadata mapstructure.Metadata
	mapstructure.DecodeMetadata(m, &p, &metadata)
	fmt.Printf("keys:%#v unused:%#v Unset:%#v \n", metadata.Keys, metadata.Unused, metadata.Unset)
	// 	keys:[]string{"user_name"} unused:[]string{"age", "job"} Unset:[]string{"user_age", "user_job"} 
}

以上就是详解golang中的结构体编解码神器Mapstructure库的详细内容，更多关于go Mapstructure的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Golang信号处理实战
本文介绍了Go语言中os/signal包的基本用法,用于处理Unix系统中的异步信号,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2025-12-12
golang基于websocket通信tcp keepalive研究记录
这篇文章主要为大家介绍了golang基于websocket通信tcp keepalive研究记录，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-06-06
golang 通过ssh代理连接mysql的操作
这篇文章主要介绍了golang 通过ssh代理连接mysql的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-12-12
Golang在图像中绘制矩形框的示例代码
这篇文章主要介绍了Golang在图像中绘制矩形框的示例代码，文中有详细的代码示例供大家参考，具有一定的参考价值,需要的朋友可以参考下
2008-08-08
golang移除数组中重复的元素操作
这篇文章主要介绍了golang移除数组中重复的元素操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-12-12
Golang自动追踪GitHub上热门AI项目
这篇文章主要为大家介绍了Golang自动追踪GitHub上热门AI项目,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-12-12
golang值接收者和指针接收者的区别介绍
这篇文章主要介绍了golang值接收者和指针接收者的区别,它和函数的区别在于方法有一个接收者，给一个函数添加一个接收者，那么它就变成了方法，接收者可以是值接收者，也可以是指针接收者，本文通过实例代码介绍的非常详细，需要的朋友可以参考下
2022-08-08
Golang中使用Mqtt的方法示例
本文介绍了Golang中使用paho.mqtt.golang库实现MQTT客户端与服务器的连接、订阅和消息收发,具有一定的参考价值,感兴趣的可以了解一下
2025-02-02
Golang设计模式之责任链模式讲解和代码示例
责任链是一种行为设计模式，允许你将请求沿着处理者链进行发送，直至其中一个处理者对其进行处理，本文就详细给大家介绍一下Golang 责任链模式，文中有详细的代码示例,需要的朋友可以参考下
2023-06-06
Go语言基于viper实现apollo多实例快速
viper是适用于go应用程序的配置解决方案，这款配置管理神器，支持多种类型、开箱即用、极易上手。本文主要介绍了如何基于viper实现apollo多实例快速接入，感兴趣的可以了解一下
2023-01-01