JSON
이론과 구조

JSON의 역사

JSON은 특정 시점에 발명된 것이 아니라 발견되었습니다. Douglas Crockford는 2001년 JavaScript의 객체 리터럴 표기법이 이미 훌륭한 데이터 포맷임을 인식하고 이를 공식화했습니다.

문법 구조

JSON은 두 가지 구조만으로 이루어집니다. 객체(Object)와 배열(Array)입니다. 이 두 구조는 재귀적으로 중첩 가능합니다.

{
  "name": "김철수",
  "age":  28,
  "isActive": true,
  "score":  98.5,
  "nickname": null,
  "tags":   ["개발자", "서울"],
  "address": {
    "city":   "서울특별시",
    "zip":    "04524"
  }
}

Object 문법

중괄호 { }로 감싸며, "키"와 값을 콜론으로 연결합니다. 쌍은 쉼표로 구분합니다. 키는 반드시 큰따옴표로 감싼 문자열이어야 합니다.

{  ← 시작
  "key1" : value1 ,   ← 쌍1
  "key2" : value2      ← 쌍N (마지막 쉼표 금지)
}  ← 종료

Array 문법

대괄호 [ ]로 감싸며, 값들을 쉼표로 구분합니다. 배열 안에 다른 타입이 혼재할 수 있지만, 실무에서는 동일 타입을 사용합니다.

[  ← 시작
  value1,    ← 요소1
  value2,    ← 요소2
  { "nested": true }  ← 중첩 객체도 OK
]  ← 종료

6가지 데이터 타입

JSON은 딱 여섯 가지 타입만 지원합니다. 날짜, 함수, undefined 같은 타입은 존재하지 않습니다.

이스케이프 시퀀스

문자열 내에서 특수 문자를 표현할 때 백슬래시를 사용합니다.

"\""   ← 큰따옴표
"\\"   ← 백슬래시
"\n"   ← 줄바꿈 (LF)
"\r"   ← 캐리지 리턴
"\t"   ← 탭
"\uAC00" ← 가 (유니코드 코드포인트)

인터랙티브 파서

JSON을 입력하면 실시간으로 파싱하여 트리 구조로 시각화합니다.

자주 틀리는 규칙

인코딩

RFC 8259는 UTF-8을 유일한 표준 인코딩으로 지정합니다. BOM(Byte Order Mark) 사용도 금지됩니다. 네트워크 전송 시 UTF-16·32도 허용했던 RFC 4627과 다릅니다.

JSON Schema

JSON Schema는 JSON 데이터의 구조를 JSON으로 기술하는 메타 포맷입니다. 데이터 검증, 문서화, 코드 생성에 사용됩니다.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type":    "object",
  "required": ["name", "age"],
  "properties": {
    "name": {
      "type":      "string",
      "minLength": 1,
      "maxLength": 50
    },
    "age": {
      "type":    "integer",
      "minimum": 0,
      "maximum": 150
    },
    "email": {
      "type":   "string",
      "format": "email"
    }
  },
  "additionalProperties": false
}

주요 키워드

다른 포맷과 비교

JSON vs XML

{
  "user": {
    "name": "김철수",
    "age": 28,
    "tags": ["dev", "seoul"]
  }
}

<user>
  <name>김철수</name>
  <age>28</age>
  <tags>
    <tag>dev</tag>
    <tag>seoul</tag>
  </tags>
</user>

JSON은 XML보다 가독성이 높고 용량이 작습니다. XML은 속성(attribute), 네임스페이스, DTD 같은 복잡한 기능이 있지만 파싱이 무겁습니다.

JSON vs YAML

{
  "name": "service",
  "port": 8080,
  "debug": false,
  "hosts": ["a", "b"]
}

name: service
port: 8080
debug: false
hosts:
  - a
  - b

YAML은 사람이 읽기 더 편하고 주석을 지원합니다. 단, 들여쓰기 민감도, 암시적 타입 변환 등으로 파싱 오류가 발생하기 쉽습니다. JSON은 YAML의 subset(거의)입니다.

JSON vs Protocol Buffers

Protocol Buffers(protobuf)는 구글이 개발한 이진 직렬화 포맷입니다. JSON보다 3~10배 작고 파싱이 빠르지만, 스키마(.proto)가 필요하고 사람이 읽을 수 없습니다. 고성능 내부 API에 적합합니다.

JSON의 실용적 활용