設定ファイル処理
このドキュメントでは、CyberGo JSON を使って典型的な設定ファイルシナリオを処理する方法を示します: 読込、ネスト値の取得、変更、保存、デフォルト設定とユーザー設定のマージ。
設定ファイルの完全なライフサイクル
設定読込 → ネスト値の取得 → 変更 → ファイルへ保存 → 再読込して検証。例は単独実行できるよう一時ファイルを使用します。
go
package main
import (
"fmt"
"os"
"path/filepath"
"github.com/cybergodev/json"
)
func main() {
// 例が単独実行できるよう一時ディレクトリを使用
tmpDir, err := os.MkdirTemp("", "cybergo-config-*")
if err != nil {
panic(err)
}
defer os.RemoveAll(tmpDir)
configPath := filepath.Join(tmpDir, "config.json")
// 初期設定ファイルを書き込み
initial := `{
"server": {"host": "0.0.0.0", "port": 8080},
"database": {"host": "localhost", "port": 5432, "name": "appdb"},
"logging": {"level": "info"}
}`
if err := os.WriteFile(configPath, []byte(initial), 0644); err != nil {
panic(err)
}
// 1. ファイルから設定を読込
data, err := json.LoadFromFile(configPath)
if err != nil {
panic(err)
}
// 2. ネスト値を取得（オプションのデフォルト値引数をサポート）
fmt.Printf("サーバー: %s:%d\n", json.GetString(data, "server.host"), json.GetInt(data, "server.port"))
fmt.Printf("データベース: %s/%s\n", json.GetString(data, "database.host"), json.GetString(data, "database.name"))
fmt.Printf("ログレベル: %s\n", json.GetString(data, "logging.level", "info"))
// 3. 設定を変更（既存値の更新）
data, err = json.Set(data, "server.port", 9090)
if err != nil {
panic(err)
}
data, err = json.Set(data, "logging.level", "debug")
if err != nil {
panic(err)
}
// 4. ファイルへ保存（整形出力）
if err := json.SaveToFile(configPath, data, json.PrettyConfig()); err != nil {
panic(err)
}
// 5. 再読込して変更が永続化されたことを検証
reloaded, err := json.LoadFromFile(configPath)
if err != nil {
panic(err)
}
fmt.Printf("再起動後ポート: %d\n", json.GetInt(reloaded, "server.port"))
fmt.Printf("再起動後ログ: %s\n", json.GetString(reloaded, "logging.level"))
}デフォルト設定とユーザー設定のマージ
実際のアプリでは、組み込みのデフォルト値にユーザー設定を上書きし、欠落したネストパスを補完することがよくあります。MergeJSON はディープマージを実行し（ユーザー値が優先）、SetCreate は存在しない中間パスを自動生成します。
go
package main
import (
"fmt"
"github.com/cybergodev/json"
)
func main() {
// 組み込みデフォルト設定
defaults := `{
"server": {"host": "0.0.0.0", "port": 8080, "timeout": 30},
"database": {"host": "localhost", "port": 5432, "pool": 10},
"logging": {"level": "info", "format": "json"}
}`
// ユーザー設定（一部フィールドを上書き）
userConfig := `{
"server": {"port": 3000},
"database": {"host": "db.prod.example.com"},
"logging": {"level": "debug"}
}`
// ディープマージ: ユーザー設定がデフォルトを上書き、未上書きのデフォルトフィールドは保持
merged, err := json.MergeJSON(defaults, userConfig)
if err != nil {
panic(err)
}
fmt.Printf("ポート: %d（ユーザー上書き）\n", json.GetInt(merged, "server.port"))
fmt.Printf("タイムアウト: %d（デフォルト保持）\n", json.GetInt(merged, "server.timeout"))
fmt.Printf("データベース: %s:%d\n", json.GetString(merged, "database.host"), json.GetInt(merged, "database.port"))
// SetCreate で存在しないネストパスを追加（中間オブジェクトを自動生成）
merged, err = json.SetCreate(merged, "features.metrics.enabled", true)
if err != nil {
panic(err)
}
merged, err = json.SetCreate(merged, "features.metrics.endpoint", "/metrics")
if err != nil {
panic(err)
}
fmt.Printf("メトリクス有効: %v\n", json.GetBool(merged, "features.metrics.enabled"))
fmt.Printf("メトリクスエンドポイント: %s\n", json.GetString(merged, "features.metrics.endpoint"))
}
// 出力:
// ポート: 3000（ユーザー上書き）
// タイムアウト: 30（デフォルト保持）
// データベース: db.prod.example.com:5432
// メトリクス有効: true
// メトリクスエンドポイント: /metricsヒント
MergeJSON はディープな再帰マージを行います: オブジェクトキーは階層ごとにマージされ、配列とスカラー値は直接置換されます。複数の設定ソースを一度にマージするには MergeMany([]string{...}) を使います。