JSON 処理ライブラリ

github.com/cybergodev/json は、高性能でスレッドセーフな Go JSON 処理ライブラリです。解析、クエリ、変更、検証、フォーマットなど豊富な JSON 操作機能を提供しながら、標準ライブラリ encoding/json との 100% 互換性を維持しています。

主な特徴

• 100% encoding/json 互換 — 標準ライブラリのシームレスな置き換え、既存コードの変更不要
• スレッドセーフ — すべての操作が並行安全、高並行シナリオに対応
• パスクエリ — JSONPath スタイルのパス式をサポート、ワイルドカード・スライス含む
• 型安全な取得 — ジェネリック API (GetTyped[T]) と型アサーションメソッド (SafeGet)
• ストリーミング処理 — 大規模ファイルや JSONL/NDJSON 形式のストリーミング処理をサポート
• セキュリティ保護 — 入力検証、深さ制限、危険パターン検出を内蔵
• 高性能キャッシュ — スマートキャッシュ、事前解析最適化、オブジェクトプール再利用
• 拡張可能 — フックシステム、カスタムエンコーダ、バリデータ

インストール

go get github.com/cybergodev/json

30 秒クイック体験

package main

import (
    "fmt"
    "github.com/cybergodev/json"
)

func main() {
    data := `{"name": "CyberGo", "version": 1, "tags": ["json", "go"]}`

    // 1. パス取得
    name := json.GetString(data, "name")
    fmt.Println("Name:", name)

    // 2. 値の変更
    updated, _ := json.Set(data, "version", 2)
    fmt.Println("Updated:", updated)

    // 3. 検証
    if json.Valid([]byte(data)) {
        fmt.Println("Valid JSON")
    }

    // 4. デフォルト値付き取得
    desc := json.GetString(data, "description", "デフォルト説明")
    fmt.Println("Description:", desc)

    // 5. 構造体にデコード
    type Config struct {
        Name    string   `json:"name"`
        Version int      `json:"version"`
        Tags    []string `json:"tags"`
    }
    var config Config
    json.Unmarshal([]byte(data), &config)
    fmt.Printf("Config: %+v\n", config)
}

機能概要

パス操作

機能	関数	説明
値の取得	Get, GetString, GetInt...	ネストされたパス、配列インデックスをサポート
デフォルト値付き取得	GetString, GetInt など	defaultValue パラメータを渡す
値の設定	Set	存在しないパスを自動作成（Config.CreatePaths）
値の削除	Delete	指定パスを削除

エンコード・デコード

機能	関数	説明
エンコード	Marshal, MarshalIndent	encoding/json と 100% 互換
デコード	Unmarshal, Parse, ParseAny	ジェネリックと型安全をサポート
フォーマット	Prettify, Compact	JSON 整形・圧縮

高度な機能

機能	関数/型	説明
ジェネリック API	GetTyped[T]	型安全なジェネリック取得
事前解析	Processor.PreParse, Processor.GetFromParsed	一度解析して複数回クエリ
安全な取得	SafeGet → AccessResult	チェーン式の型変換
ストリーミング処理	Processor.ForeachFile	大規模ファイルのメモリフレンドリー処理
JSONL 処理	StreamLinesInto[T]	ログ/データパイプライン
Schema 検証	ValidateSchema	JSON Schema 検証

モジュールナビゲーション

モジュール	説明
クイックスタート	インストール、基本操作、コア概念
パス式の構文	パスクエリ、スライス、ワイルドカード、フィールド抽出
API ドキュメント	完全な API リファレンス
大規模ファイル処理	ストリーミング処理、チャンク読み書き、メモリ最適化
使用例	実践的なコードサンプル
高度な機能の例	バッチエンコード、事前解析、フックシステム

パフォーマンス特性

• ゼロコピー解析 — メモリ割り当てを削減
• スマートキャッシュ — ホットパスを自動キャッシュ、キャッシュウォームアップをサポート
• オブジェクトプール — 中間オブジェクトの再利用、GC 負荷を低減
• 並列処理 — バッチ操作の自動並列化
• 事前解析最適化 — 大型 JSON を一度解析して複数回クエリ

標準ライブラリとの比較

機能	encoding/json	cybergodev/json
基本エンコード・デコード	✅	✅ 100% 互換
パスクエリ	❌	✅ ドット/ブラケット構文
型安全な取得	❌	✅ ジェネリック API
ストリーミング処理	基本的	✅ 強化版
JSONL サポート	❌	✅ ネイティブサポート
セキュリティ検証	❌	✅ 内蔵保護
フックシステム	❌	✅ 拡張可能
キャッシュ最適化	❌	✅ スマートキャッシュ

クイック意思決定ガイド

シナリオ	推奨アプローチ
シンプルなクエリ	GetString(data, "path")
デフォルト値付き	GetString(data, "path", "default")
型安全	GetTyped[User](data, "user")
高頻度クエリ	Processor + PreParse
大規模ファイル	Processor.ForeachFile
信頼できない入力	SecurityConfig()

次のステップ

• クイックスタート — 5 分で始める
• パス式の構文 — 完全なパス構文
• 使用例 — より多くの実践的なサンプル