Golang无需结构体类型安全的JSON处理与查询插件库jsonic的使用

JSONIC简介

Jsonic 是一个完整的JSON数据处理工具集，无需定义结构体即可安全地进行JSON嵌套查询。该库提供了强类型方法，无需编写额外代码即可获得所需结果。

安装

go get github.com/sinhashubham95/jsonic

查询路径理解

Jsonic 使用一种独特而简单的方式来查询JSON中的元素。考虑以下JSON示例：

{
  "a": {
    "x": "p",
    "arr": [
      {
        "a": "b",
        "c.d": {
          "e": "f"
        }
      }
    ]
  },
  "c": "d",
  "a.x": {
    "y": "q"
  },
  "a.x.y": {
    "z": "r"
  }
}

查询路径解析示例：

使用方法

创建新实例

import (
  "github.com/sinhashubham95/jsonic"
)

func New() {
  json := "{\"naruto\": \"rocks\"}"
  j, err := jsonic.New([]byte(json))
  // 使用创建的实例执行任何操作
}

创建子实例

import (
  "github.com/sinhashubham95/jsonic"
)

func Child() {
  json := "{\"naruto\": \"rocks\"}"
  j, err := jsonic.New([]byte(json))
  if err != nil {
    return
  }
  
  // 创建子实例
  child, err := j.Child("naruto")
  // 现在可以使用这个子实例进行查询
}

获取路径数据

import (
  "github.com/sinhashubham95/jsonic"
)

func Get() {
  json := "{\"naruto\": \"rocks\"}"
  j, err := jsonic.New([]byte(json))
  if err != nil {
    return
  }
  
  // 获取数据
  data, err := j.Get("naruto")
  // data将是interface{}类型，值为"rocks"
}

获取类型化数据

import (
  "github.com/sinhashubham95/jsonic"
)

type Detail struct {
  Name string `json:"name"`
}

func GetTyped() {
  json := "{\"characters\": [{\"name\": \"naruto\"}, {\"name\": \"boruto\"}]}"
  j, err := jsonic.New([]byte(json))
  if err != nil {
    return
  }
  
  // 获取类型化数据
  var data []Detail
  err := j.GetTyped("characters", &data)
  // data将包含2个元素，name分别为naruto和boruto
}

其他类型化工具方法

import (
  "github.com/sinhashubham95/jsonic"
)

func OtherGetters(j *jsonic.Jsonic, path string) {
  // 基本类型
  i, err := j.GetInt(path)                    // int
  i64, err := j.GetInt64(path)                // int64
  f, err := j.GetFloat(path)                  // float32
  f64, err := j.GetFloat64(path)              // float64
  b, err := j.GetBool(path)                   // bool
  s, err := j.GetString(path)                 // string

  // 数组
  a, err := j.GetArray(path)                  // []interface{}
  iArr, err := j.GetIntArray(path)            // []int
  i64Arr, err := j.GetInt64Array(path)        // []int64
  fArr, err := j.GetFloatArray(path)          // []float32
  f64Arr, err := j.GetFloat64Array(path)      // []float64
  bArr, err := j.GetBoolArray(path)           // []bool
  sArr, err := j.GetStringArray(path)         // []string

  // 映射
  m, err := j.GetMap(path)                    // map[string]interface{}
  iMap, err := j.GetIntMap(path)              // map[string]int
  i64Map, err := j.GetInt64Map(path)          // map[string]int64
  fMap, err := j.GetFloatMap(path)            // map[string]float32
  f64Map, err := j.GetFloat64Map(path)        // map[string]float64
  bMap, err := j.GetBoolMap(path)             // map[string]bool
  sMap, err := j.GetStringMap(path)           // map[string]string
}

完整示例

package main

import (
	"fmt"
	"github.com/sinhashubham95/jsonic"
)

func main() {
	// 示例JSON数据
	jsonData := `{
		"user": {
			"name": "John Doe",
			"age": 30,
			"address": {
				"street": "123 Main St",
				"city": "New York"
			},
			"hobbies": ["reading", "coding", "gaming"],
			"scores": {
				"math": 95,
				"science": 88
			}
		}
	}`

	// 创建Jsonic实例
	j, err := jsonic.New([]byte(jsonData))
	if err != nil {
		fmt.Println("创建Jsonic实例失败:", err)
		return
	}

	// 获取用户名
	name, err := j.GetString("user.name")
	if err != nil {
		fmt.Println("获取用户名失败:", err)
	} else {
		fmt.Println("用户名:", name)
	}

	// 获取年龄
	age, err := j.GetInt("user.age")
	if err != nil {
		fmt.Println("获取年龄失败:", err)
	} else {
		fmt.Println("年龄:", age)
	}

	// 获取城市
	city, err := j.GetString("user.address.city")
	if err != nil {
		fmt.Println("获取城市失败:", err)
	} else {
		fmt.Println("城市:", city)
	}

	// 获取爱好列表
	hobbies, err := j.GetStringArray("user.hobbies")
	if err != nil {
		fmt.Println("获取爱好列表失败:", err)
	} else {
		fmt.Println("爱好:")
		for i, hobby := range hobbies {
			fmt.Printf("  %d. %s\n", i+1, hobby)
		}
	}

	// 获取数学成绩
	mathScore, err := j.GetInt("user.scores.math")
	if err != nil {
		fmt.Println("获取数学成绩失败:", err)
	} else {
		fmt.Println("数学成绩:", mathScore)
	}

	// 使用Child创建子实例
	user, err := j.Child("user")
	if err != nil {
		fmt.Println("创建子实例失败:", err)
		return
	}

	// 从子实例获取数据
	street, err := user.GetString("address.street")
	if err != nil {
		fmt.Println("获取街道失败:", err)
	} else {
		fmt.Println("街道:", street)
	}

	// 使用GetTyped获取结构化数据
	type Address struct {
		Street string `json:"street"`
		City   string `json:"city"`
	}

	type User struct {
		Name    string   `json:"name"`
		Age     int      `json:"age"`
		Address Address  `json:"address"`
		Hobbies []string `json:"hobbies"`
	}

	var userData User
	err = j.GetTyped("user", &userData)
	if err != nil {
		fmt.Println("获取用户数据失败:", err)
	} else {
		fmt.Printf("用户数据: %+v\n", userData)
	}
}

这个示例展示了如何使用jsonic库进行各种JSON查询操作，包括基本类型查询、数组查询、嵌套对象查询以及类型化数据获取。