SJF4J: Java용 구조화된 JSON 파사드
Source: Dev.to
Introduction
Java에서 JSON을 다룰 때 보통 두 가지 접근 방식 중 하나를 선택하게 됩니다:
- 데이터 바인딩 (POJO) – 강한 타입 지정, 하지만 경직됨
- 트리 모델 (JsonNode / Map) – 유연함, 하지만 구조가 없음
대부분의 라이브러리는 하나를 강제로 선택하게 하고 그에 따른 트레이드‑오프를 감수하도록 합니다.
SJF4J (Simple JSON Facade for Java)는 다른 접근 방식을 취합니다:
- JSON 파서가 아님 – 기존 파서(예: Jackson) 위에 구축된 파사드 레이어
- 통합된 노드 모델 제공
- 구조화된 접근 + 동적 접근 지원
- 스키마 인식 기능 제공
- JSON 의미론 기반 연산 지원
목표는 JSON 처리를 보다 일관되고 표현력 있게, 확장 가능하도록 만드는 것입니다. SJF4J에서는 모든 JSON 값이 일관된 동작을 갖는 노드로 취급됩니다. 다음과 같은 방법으로 조작할 수 있습니다:
- 객체‑지향 API (
JsonObject,JsonArray) - 정적 유틸리티 (
Nodes)
두 가지 접근 스타일을 지원합니다:
toXxx()→ 타입‑안전 접근asXxx()→ 의미론적 변환
이로 인해 파싱 스타일을 계속 전환할 필요가 사라집니다.
Hybrid Model (JOJO)
핵심 기능 중 하나는 SJF4J가 POJO와 동적 JSON 사이에 엄격한 경계를 강요하지 않는다는 점입니다. 구조화된 필드를 정의하면서도 유연한 확장을 허용할 수 있습니다.
public class Student extends JsonObject {
private String name;
private Map scores;
private List friends;
}이는 전통적인 POJO도 아니고 순수 JSON 트리도 아닌—SJF4J가 JOJO(JSON Object Java Object)라고 부르는 하이브리드 모델입니다.
Core Features
Navigation & Patch
- JSON Path‑유사 네비게이션
- Patch‑스타일 업데이트
student.putByPath("$.profile.name", "Alice");이 기능들을 통해 수동 트래버설 없이도 깊게 중첩된 구조를 조작할 수 있습니다.
Schema Integration
SJF4J는 JSON Schema를 런타임 개념으로 통합합니다:
- 데이터를 동적으로 검증
- 조건부 규칙 지원
- 도메인 불변 조건을 런타임 제약과 분리
이는 Jakarta Bean Validation 같은 전통적인 검증 접근 방식을 보완합니다.
Cross‑Cutting Operations
- 경로 네비게이션
- Patch 업데이트
- 스키마 검증
모두 기존 파서 위에 구축되므로 성능은 기반 구현에 따라 달라집니다.
Performance Considerations
- 일반적인 시나리오에서는 오버헤드가 적당합니다.
- 경우에 따라 (예: JOJO + 최적화된 I/O) 성능이 직접 파서를 사용하는 것과 비슷하거나 약간 더 좋을 수 있습니다.
설계 목표는 큰 비용 없이 기능을 제공하는 것입니다.
When to Use SJF4J
다음 상황에 유용합니다:
- JSON 구조가 부분적으로 동적일 때.
- 타입‑안전 접근과 유연한 필드가 모두 필요할 때.
- 스키마가 시간이 지나면서 진화할 때.
- JSON 연산을 위한 통합 모델이 필요할 때.
다음 경우에는 필요성이 낮습니다:
- 스키마가 완전히 정적일 때.
- 단순한 직렬화/역직렬화만 필요할 때.
Relationship to Other Libraries
Jackson과 Gson은 다음에 강점이 있습니다:
- 직렬화 / 역직렬화
- 데이터 바인딩
SJF4J는 다른 레이어에 초점을 맞춥니다:
- 구조화된 데이터 모델로서의 JSON
- 교차 절단 연산 (경로, 패치, 스키마)
- 정적 + 동적 접근의 하이브리드
기존 라이브러리를 대체하는 것이 아니라, 그 위에 구축되는 레이어입니다.