Processor

Processor는 고성능, 사용자 정의 가능성 및 유연한 재사용 능력을 제공하여 동일한 데이터 소스에 대한 여러 작업에 적합합니다.

특징

고성능: 내부 캐시 메커니즘으로 반복 작업이 더 효율적
설정 가능: 다양한 설정 옵션 지원
체인 호출: 메서드가 수정된 JSON을 반환하여 연속 작업 지원
리소스 관리: 명시적 수명 주기 제어

Processor 생성

New

시그니처: func New(cfg ...Config) (*Processor, error)

Processor 인스턴스를 생성합니다. 선택적 Config 매개변수로 프로세서를 설정합니다.

// 기본 설정 사용
processor, err := json.New()
if err != nil {
    panic(err)
}
defer processor.Close()

// 사용자 정의 설정 사용
cfg := json.DefaultConfig()
cfg.StrictMode = true
processor, err := json.New(cfg)

// 보안 설정 사용
processor, err = json.New(json.SecurityConfig())

체인 호출

Processor 메서드는 수정된 JSON 문자열을 반환하여 연속 작업을 지원합니다:

processor, _ := json.New()

// 여러 값 설정
result1, _ := processor.Set(data, "user.name", "CyberGo")
result2, _ := processor.Set(result1, "user.version", "1.0.0")
finalResult, _ := processor.Delete(result2, "user.temporary")

API 목록

카테고리	설명
경로 조회	GetString/Int/Float/Bool/Get/SafeGet/GetArray/GetObject
데이터 수정	Set/Delete/DeleteClean
출력 메서드	Encode/EncodePretty/EncodeWithConfig/Buffer 작업
파싱과 로딩	ParseAny/Valid/LoadFromFile/LoadFromReader
반복 메서드	Foreach/ForeachWithPath/ForeachNested
배치 작업	ProcessBatch
JSONL 처리	StreamJSONL/Parallel/Chunked/Map/Reduce/Filter
수명 주기	Close/캐시/통계/상태 확인

전역 프로세서 관리

패키지 수준 함수는 내부 전역 프로세서를 사용합니다. 다음 함수로 관리할 수 있습니다:

SetGlobalProcessor

시그니처: func SetGlobalProcessor(processor *Processor)

사용자 정의 전역 프로세서를 설정합니다. 모든 패키지 수준 함수(Get, Set, Marshal 등)가 이 프로세서를 사용합니다.

매개변수

이름	타입	설명
`processor`	`*Processor`	사용자 정의 프로세서 인스턴스

package main

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

func main() {
    // 사용자 정의 설정의 프로세서 생성
    cfg := json.SecurityConfig()
    processor, err := json.New(cfg)
    if err != nil {
        panic(err)
    }

    // 전역 프로세서로 설정
    json.SetGlobalProcessor(processor)

    // 이제 모든 패키지 수준 함수가 보안 설정을 사용합니다
    data, err := json.Get(`{"name":"Alice"}`, "name")
    // SecurityConfig의 제한이 적용됨
    _ = data
}

주의

nil을 전달하면 아무 작업도 수행하지 않습니다
이전 전역 프로세서는 자동으로 종료됩니다
이 함수는 스레드 안전합니다

ShutdownGlobalProcessor

시그니처: func ShutdownGlobalProcessor()

전역 프로세서를 종료하고 제거합니다. 이후 패키지 수준 작업은 새로운 기본 프로세서를 생성합니다.

package main

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

func main() {
    // 전역 프로세서 사용
    data, _ := json.Get(`{"key":"value"}`, "key")
    _ = data

    // 애플리케이션 종료 시 정리
    json.ShutdownGlobalProcessor()

    // 이후 작업은 새로운 기본 프로세서를 생성합니다
    data2, _ := json.Get(`{"key":"value2"}`, "key")
    _ = data2
}

사용 시나리오

장기 실행 서비스의 종료 시 리소스 정리
프로세서 설정 초기화 필요 시
테스트 환경에서 테스트 케이스 격리

Processor ​

특징 ​

Processor 생성 ​

New ​

체인 호출 ​

API 목록 ​

전역 프로세서 관리 ​

SetGlobalProcessor ​

ShutdownGlobalProcessor ​

관련 문서 ​