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	체인 타입 변환
스트림 처리	NDJSONProcessor	줄 단위 스트리밍, 메모리 제어 가능
JSONL 처리	StreamLinesInto[T]	로그/데이터 파이프라인
Schema 검증	ValidateSchema	JSON Schema 검증

모듈 탐색

모듈	설명
빠른 시작	설치, 기본 사용법, 핵심 개념
경로 표현식 문법	경로 쿼리, 슬라이스, 와일드카드, 필드 추출
Processor 가이드	언제 Processor 를 사용할까, 사전 파싱 최적화, 수명 주기
API 문서	완전한 API 참조
대용량 파일 처리	스트림 처리, 청크 읽기/쓰기, 메모리 최적화
사용 예제	실전 코드 예제
고급 기능 예제	배치 인코딩, 사전 파싱, 훅 시스템

성능 특징

• 제로 카피 파싱 — 메모리 할당 감소
• 스마트 캐시 — 핫 경로 자동 캐시, 캐시 웜업 지원
• 객체 풀 — 중간 객체 재사용, GC 압력 감소
• 병렬 스트림 처리 — JSONL 스트리밍 처리에서 다중 worker 병렬 지원 (StreamJSONLParallel)
• 사전 파싱 최적화 — 대형 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 분 안에 시작하기
• Processor 가이드 — 언제 프로세서를 사용할까
• 경로 표현식 문법 — 완전한 경로 문법
• 사용 예제 — 더 많은 실전 예제