수정 함수

json 패키지가 제공하는 JSON 수정 함수로, 경로 설정, 배치 업데이트 및 병합 작업을 지원합니다.

설정 함수

Set

시그니처: func Set(jsonStr, path string, value any, cfg ...Config) (string, error)

지정된 경로에 값을 설정하고, 수정된 JSON 문자열을 반환합니다.

매개변수

이름	타입	필수	설명
`jsonStr`	`string`	예	JSON 문자열
`path`	`string`	예	경로 표현식
`value`	`any`	예	설정할 값
`cfg`	`Config`	아니오	선택적 설정

예제

result, err := json.Set(`{"user":{}}`, "user.name", "Alice")
if err != nil {
    panic(err)
}
fmt.Println(result) // {"user":{"name":"Alice"}}

경로가 존재하지 않을 때 자동 생성

// 중간 경로 자동 생성
result, err := json.Set(`{}`, "user.profile.name", "Bob")
// {"user":{"profile":{"name":"Bob"}}}

다양한 타입 값 설정

data := `{}`

// 문자열 설정
json.Set(data, "user.name", "Alice")

// 숫자 설정
json.Set(data, "user.age", 30)

// 불리언 설정
json.Set(data, "user.active", true)

// null 설정
json.Set(data, "user.deleted", nil)

// 중첩 객체 설정
json.Set(data, "user.address", map[string]any{
    "city": "Seoul",
    "zip":  "04500",
})

// 배열 설정
json.Set(data, "user.tags", []string{"admin", "developer"})

SetMultiple

시그니처: func SetMultiple(jsonStr string, updates map[string]any, cfg ...Config) (string, error)

여러 경로의 값을 배치로 설정합니다.

매개변수

이름	타입	필수	설명
`jsonStr`	`string`	예	JSON 문자열
`updates`	`map[string]any`	예	경로 - 값 매핑
`cfg`	`Config`	아니오	선택적 설정

예제

updates := map[string]any{
    "user.name": "Bob",
    "user.age":  25,
    "user.email": "[email protected]",
}
result, err := json.SetMultiple(data, updates)
if err != nil {
    panic(err)
}
fmt.Println(result)

성능 이점

여러 수정 작업의 경우 SetMultiple이 Set을 여러 번 호출하는 것보다 더 효율적입니다:

// 권장: 한 번의 호출
updates := map[string]any{"a": 1, "b": 2, "c": 3}
result, err := json.SetMultiple(data, updates)

// 비권장: 여러 번의 호출
result, err = json.Set(data, "a", 1)
result, err = json.Set(result, "b", 2)
result, err = json.Set(result, "c", 3)

SetCreate

시그니처: func SetCreate(jsonStr, path string, value any, cfg ...Config) (string, error)

값을 설정하고 존재하지 않는 중간 경로를 자동으로 생성합니다. Config.CreatePaths = true로 설정한 Set과 동일합니다.

// 중간 경로가 존재하지 않을 때 자동 생성
result, err := json.SetCreate(`{}`, "user.profile.bio", "Developer")
// {"user":{"profile":{"bio":"Developer"}}}

SetMultipleCreate

시그니처: func SetMultipleCreate(jsonStr string, updates map[string]any, cfg ...Config) (string, error)

여러 값을 배치로 설정하고 중간 경로를 자동으로 생성합니다.

result, err := json.SetMultipleCreate(`{}`, map[string]any{
    "user.profile.bio":      "Developer",
    "user.profile.location": "Korea",
})

병합 함수

MergeJSON

시그니처: func MergeJSON(json1, json2 string, cfg ...Config) (string, error)

깊은 병합 전략을 사용하여 두 JSON 객체를 병합합니다. 중첩 객체의 경우 Config.MergeMode에서 지정한 모드에 따라 키를 재귀적으로 병합합니다. 원시 값과 배열의 경우 patch 값이 우선합니다.

매개변수

이름	타입	필수	설명
`json1`	`string`	예	기본 JSON 문자열
`json2`	`string`	예	덮어쓰기 JSON 문자열
`cfg`	`...Config`	아니오	선택적 설정 (`MergeMode`로 병합 모드 설정)

병합 모드 (Config.MergeMode로 설정, 기본값은 MergeUnion):

모드	객체 동작	배열 동작
`MergeUnion`	모든 키를 병합하고 충돌 시 patch 값 사용	모든 요소를 병합하고 중복 제거
`MergeIntersection`	공통 키만 보존, 값은 patch 에서 가져옴	공통 요소만 보존
`MergeDifference`	base 에만 존재하는 키만 보존	base 에만 존재하는 요소만 보존

base := `{"a": 1, "b": 2, "nested": {"x": 10, "y": 20}}`
override := `{"b": 3, "c": 4, "nested": {"y": 30, "z": 40}}`

// 통합 병합 (기본값)
result, _ := json.MergeJSON(base, override)
// 결과: {"a":1,"b":3,"c":4,"nested":{"x":10,"y":30,"z":40}}

// 교집합 병합 - 공통 키만 보존
cfg := json.DefaultConfig()
cfg.MergeMode = json.MergeIntersection
result, _ = json.MergeJSON(base, override, cfg)
// 결과: {"b":3,"nested":{"y":30}}

// 차집합 병합 - base 에만 존재하는 키만 보존
cfg = json.DefaultConfig()
cfg.MergeMode = json.MergeDifference
result, _ = json.MergeJSON(base, override, cfg)
// 결과: {"a":1,"nested":{"x":10}}

MergeMany

시그니처: func MergeMany(jsons []string, cfg ...Config) (string, error)

여러 JSON 객체를 병합합니다. 최소 2 개의 JSON 문자열이 필요합니다. Config.MergeMode로 병합 모드를 설정할 수 있습니다.

매개변수

이름	타입	필수	설명
`jsons`	`[]string`	예	병합할 JSON 문자열 슬라이스 (최소 2 개)
`cfg`	`...Config`	아니오	선택적 설정 (`MergeMode`로 병합 모드 설정)

config1 := `{"api": "v1", "timeout": 30, "retries": 1}`
config2 := `{"timeout": 60, "retries": 3}`
config3 := `{"retries": 5, "debug": true}`

// 기본 통합 병합
result, err := json.MergeMany([]string{config1, config2, config3})
// 결과: {"api":"v1","timeout":60,"retries":5,"debug":true}

Processor 메서드

Processor 는 패키지 레벨 함수와 동일한 시그니처의 수정 메서드를 제공합니다:

p, err := json.New()

result, err := p.Set(jsonStr, "user.name", "Alice")
result, err = p.Delete(jsonStr, "user.temp")
result, err = p.SetCreate(jsonStr, "user.email", "[email protected]")

MergeJSON, MergeMany에도 대응하는 Processor 메서드가 있으며, 시그니처는 패키지 레벨 함수와 동일하여 이미 설정된 Processor 를 재사용하기 편리합니다:

result, err := p.MergeJSON(base, override)

merged, err := p.MergeMany([]string{config1, config2, config3})

// CompareJSON 에도 Processor 메서드가 있습니다 (주의: Processor.CompareJSON 은
// 항상 보안 검증을 수행하며, 패키지 레벨 함수의 cfg 없는 경로와 다릅니다)
equal, err := p.CompareJSON(a, b)

자세한 내용은 Processor 데이터 수정을 참조하세요.

수정 함수 ​

설정 함수 ​

Set ​

SetMultiple ​

SetCreate ​

SetMultipleCreate ​

병합 함수 ​

MergeJSON ​

MergeMany ​

Processor 메서드 ​

관련 문서 ​

수정 함수

설정 함수

Set

SetMultiple

SetCreate

SetMultipleCreate

병합 함수

MergeJSON

MergeMany

Processor 메서드

관련 문서