Skip to content

バッチ操作関数

json パッケージが提供するバッチ操作関数。複数の JSON 操作(get/set/delete/validate)を一度に処理でき、バッチデータ処理シナリオに適しています。

バッチ操作

ProcessBatch

シグネチャ:func ProcessBatch(operations []BatchOperation, cfg ...Config) ([]BatchResult, error)

複数の JSON 操作をバッチ処理します(パッケージレベル関数、Processor の作成不要)。

go
package main

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

func main() {
    jsonStr := `{"user": {"name": "CyberGo", "age": 25}}`

    operations := []json.BatchOperation{
        {Type: "get", JSONStr: jsonStr, Path: "user.name", ID: "op1"},
        {Type: "set", JSONStr: jsonStr, Path: "user.age", Value: 30, ID: "op2"},
    }

    results, err := json.ProcessBatch(operations)
    if err != nil {
        panic(err)
    }
    for _, r := range results {
        if r.Error != nil {
            fmt.Printf("操作 %s 失敗: %v\n", r.ID, r.Error)
        } else {
            fmt.Printf("操作 %s 結果: %v\n", r.ID, r.Result)
        }
    }
}

BatchOperation

バッチ操作の記述構造体。

go
type BatchOperation struct {
    Type    string `json:"type"`     // 操作タイプ:"get", "set", "delete", "validate"
    JSONStr string `json:"json_str"` // 対象 JSON 文字列
    Path    string `json:"path"`     // パス式
    Value   any    `json:"value"`    // 操作値(set 操作で使用)
    ID      string `json:"id"`       // 操作識別子
}

BatchResult

バッチ操作の結果構造体。

go
type BatchResult struct {
    ID     string `json:"id"`     // 操作識別子
    Result any    `json:"result"` // 操作結果
    Error  error  `json:"error"`  // エラー情報
}

Processor バッチメソッド

Processor インスタンスはパッケージレベル関数と同じシグネチャのバッチメソッド p.ProcessBatch(operations) を提供し、Processor を再利用するシナリオに適しています。詳しくは Processor バッチ操作 を参照してください。

関連