jsongo - Golang流畅创建JSON对象的Fluent API库

jsongo是一个用于Golang的轻量级库，它提供了流畅的API(Fluent API)来创建和操作JSON对象。下面我将详细介绍它的使用方法和示例代码。

安装

go get github.com/ricardolonga/jsongo

基本用法

创建JSON对象

package main

import (
	"fmt"
	"github.com/ricardolonga/jsongo"
)

func main() {
	// 创建简单JSON对象
	json := jsongo.Object().
		Put("name", "John").
		Put("age", 30).
		Put("isMarried", false)
	
	fmt.Println(json)
	// 输出: {"name":"John","age":30,"isMarried":false}
}

创建嵌套JSON对象

func nestedObject() {
	json := jsongo.Object().
		Put("user", jsongo.Object().
			Put("name", "Alice").
			Put("email", "alice@example.com")).
		Put("roles", jsongo.Array().
			Put("admin").
			Put("editor"))
	
	fmt.Println(json)
	// 输出: {"user":{"name":"Alice","email":"alice@example.com"},"roles":["admin","editor"]}
}

创建JSON数组

func jsonArray() {
	json := jsongo.Array().
		Put(1).
		Put(2).
		Put(jsongo.Object().
			Put("id", 3).
			Put("name", "Three"))
	
	fmt.Println(json)
	// 输出: [1,2,{"id":3,"name":"Three"}]
}

动态构建JSON

func dynamicBuild() {
	// 假设我们有一些动态数据
	users := []struct {
		ID   int
		Name string
	}{
		{1, "Tom"},
		{2, "Jerry"},
	}

	// 动态构建JSON数组
	jsonArray := jsongo.Array()
	for _, user := range users {
		jsonArray.Put(jsongo.Object().
			Put("id", user.ID).
			Put("name", user.Name))
	}

	// 构建完整JSON响应
	response := jsongo.Object().
		Put("success", true).
		Put("count", len(users)).
		Put("users", jsonArray)
	
	fmt.Println(response)
	/* 输出:
	{
		"success": true,
		"count": 2,
		"users": [
			{"id":1,"name":"Tom"},
			{"id":2,"name":"Jerry"}
		]
	}
	*/
}

条件性添加字段

func conditionalFields() {
	showDetails := true
	
	json := jsongo.Object().
		Put("id", 123).
		Put("name", "Product").
		PutIf(showDetails, "details", jsongo.Object().
			Put("color", "red").
			Put("weight", 1.5))
	
	fmt.Println(json)
	// 输出: {"id":123,"name":"Product","details":{"color":"red","weight":1.5}}
	
	// 如果showDetails为false，则不会包含details字段
}

从JSON字符串解析

func fromJsonString() {
	jsonStr := `{"name":"Bob","age":25}`
	
	obj, err := jsongo.FromString(jsonStr)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	
	// 修改并添加新字段
	obj.Put("age", 26).Put("city", "New York")
	
	fmt.Println(obj)
	// 输出: {"name":"Bob","age":26,"city":"New York"}
}

高级用法

链式操作

func chainingOperations() {
	json := jsongo.Object().
		Put("timestamp", time.Now().Unix()).
		Put("data", jsongo.Array().
			Put(jsongo.Object().
				Put("id", 1).
				Put("value", "first")).
			Put(jsongo.Object().
				Put("id", 2).
				Put("value", "second"))).
		Put("metadata", jsongo.Object().
			Put("version", "1.0").
			Put("author", "me"))
	
	fmt.Println(json)
}

合并JSON对象

func mergeObjects() {
	base := jsongo.Object().Put("a", 1).Put("b", 2)
	extra := jsongo.Object().Put("b", 3).Put("c", 4)
	
	merged := base.Merge(extra)
	
	fmt.Println(merged)
	// 输出: {"a":1,"b":3,"c":4} 
	// 注意b的值被extra中的值覆盖
}

性能考虑

jsongo库在内部使用map[string]interface{}和[]interface{}来表示JSON结构和值，最终通过json.Marshal转换为JSON字符串。对于高性能场景，可以考虑以下优化：

1. 对于大量数据的处理，考虑预分配容量
2. 复用jsongo对象而不是每次都创建新对象
3. 对于简单结构，直接使用结构体+json标签可能更高效

总结

jsongo提供了以下主要优势：

1. 流畅的API接口，代码可读性高
2. 支持链式调用，方便构建复杂JSON结构
3. 支持条件性添加字段
4. 支持JSON合并等操作
5. 轻量级，无额外依赖

对于需要动态构建复杂JSON结构的场景，jsongo是一个非常实用的工具库。