utils

func JSONPretty ¶

func JSONPretty(v interface{}) string

JSONPretty returns pretty-printed JSON or empty string on error

func MarshalJSON ¶

func MarshalJSON(v interface{}) ([]byte, error)

MarshalJSON provides custom JSON serialization for objects not serializable by default MarshalJSON 为默认情况下不可序列化的对象提供自定义 JSON 序列化

Handles: - time.Time objects -> ISO 8601 format strings - Custom types implementing Stringer interface -> string representation

处理: - time.Time 对象 -> ISO 8601 格式字符串 - 实现了 Stringer 接口的自定义类型 -> 字符串表示

func MustToJSONString ¶

func MustToJSONString(v interface{}) string

MustToJSONString converts any value to JSON string, panics on error.

This function is useful in critical code paths where serialization failure indicates a programming error rather than a runtime condition.

Panics if the value cannot be serialized (e.g., contains channels or functions).

Example:

// Use when you're certain the data is serializable
// 当你确定数据可序列化时使用
jsonStr := MustToJSONString(map[string]string{
	"status": "active",
})

MustToJSONString 将任意值转换为 JSON 字符串，出错时 panic。

此函数在关键代码路径中很有用，其中序列化失败表示编程错误而不是运行时条件。

如果值无法序列化（例如包含 channel 或函数），则 panic。

func Retry ¶

func Retry(attempts int, delay time.Duration, fn func() error) error

Retry retries fn up to attempts with fixed delay

func ToJSON ¶

func ToJSON(v interface{}) ([]byte, error)

ToJSON converts any value to JSON bytes with custom serialization.

This function recursively processes the input value, converting special types (time.Time, fmt.Stringer) to JSON-serializable equivalents before marshaling.

Returns an error if the value contains types that cannot be serialized (e.g., channels, functions).

Example:

data := map[string]interface{}{
	"timestamp": time.Now(),
	"count": 42,
}
jsonBytes, err := ToJSON(data)
if err != nil {
	log.Fatal(err)
}

ToJSON 使用自定义序列化将任意值转换为 JSON 字节。

此函数递归处理输入值，在 marshal 之前将特殊类型（time.Time、fmt.Stringer） 转换为 JSON 可序列化的等价物。

如果值包含无法序列化的类型（例如 channel、函数），则返回错误。

testTime := time.Date(2025, 10, 4, 12, 30, 45, 0, time.UTC)
data := map[string]interface{}{
	"event":     "user_login",
	"timestamp": testTime,
	"user_id":   "12345",
}

jsonBytes, err := ToJSON(data)
if err != nil {
	fmt.Printf("Error: %v\n", err)
	return
}

fmt.Println(string(jsonBytes))

Output:
{"event":"user_login","timestamp":"2025-10-04T12:30:45Z","user_id":"12345"}

func ToJSONString ¶

func ToJSONString(v interface{}) (string, error)

ToJSONString converts any value to JSON string with custom serialization.

This is a convenience wrapper around ToJSON that returns a string instead of bytes. Returns an error if the value cannot be serialized.

Example:

jsonStr, err := ToJSONString(map[string]interface{}{
	"name": "agent-1",
	"createdAt": time.Now(),
})

ToJSONString 使用自定义序列化将任意值转换为 JSON 字符串。

这是 ToJSON 的便捷包装器，返回字符串而不是字节。 如果值无法序列化，则返回错误。

testTime := time.Date(2025, 10, 4, 12, 30, 45, 0, time.UTC)
data := map[string]interface{}{
	"timestamp": testTime,
}

jsonStr, err := ToJSONString(data)
if err != nil {
	fmt.Printf("Error: %v\n", err)
	return
}

fmt.Println(jsonStr)

Output:
{"timestamp":"2025-10-04T12:30:45Z"}