강의

JSON 데이터 교환 형식에 대한 간결하고 현대적인 입문: 무엇이며 왜 사실상 REST API의 표준이 되었는지, 기본 구조 — 객체 { }와 배열 [ ], 허용되는 타입(문자열 "...", 숫자, 불리언 값 true/ false, null), 중첩, XML과의 비교, JSON ↔ Java 매핑(컬렉션 Map<K, V>, HashMap<K, V>). 실전 예제와 흔한 오류: 작은따옴표, 불필요한 끝 쉼표, undefined, 앞에 0이 붙은 숫자를 다룹니다.

Jackson — Java에서 JSON을 다루는 사실상의 표준입니다: ObjectMapper로 수행하는 간단한 직렬화/역직렬화부터 @JsonProperty, @JsonIgnore, @JsonInclude, @JsonFormat 애노테이션을 통한 세밀한 제어까지. 이 강의에서는 의존성 추가( jackson-databind), 객체와 컬렉션의 읽기/쓰기, pretty-printing, 날짜 처리와 흔한 오류를 다룹니다. 여기에는 TypeReference와 함께 쓰는 제네릭, POJO의 요구 사항(매개변수 없는 생성자, getter/setter)도 포함됩니다.

이 강의에서는 Google Gson 라이브러리를 다룹니다. toJson/ fromJson으로 빠르게 시작하고, TypeToken<>을 통한 컬렉션 역직렬화, GsonBuilder의 유연한 구성( setPrettyPrinting, serializeNulls, setDateFormat)을 살펴봅니다. 또한 @SerializedName, @Expose 애너테이션과 버전 조건인 @Since/ @Until, 직접 만드는 어댑터 TypeAdapter 및 registerTypeAdapter를 알아본 뒤, Jackson과 비교하고 흔한 오류를 정리합니다.

JSON 구조가 미리 알려져 있지 않거나 자주 바뀌는 경우, 엄격한 Java 클래스 대신 범용 컨테이너인 Map, List와 JSON 트리를 사용하는 편이 더 편리합니다. 이 강의에서는 ObjectMapper를 사용해 데이터를 Map<String, Object>와 List로 읽는 방법, JsonNode와 그 메서드 get/ path/ asText()로 트리를 안전하게 순회하는 방법, 그리고 Gson의 JsonElement, JsonObject, JsonArray를 활용하는 대안을 다룹니다. 마지막으로 구성(config)을 추출하는 실습과 흔한 오류를 정리합니다.

역직렬화 전에 JSON 형식의 입력 데이터를 왜 그리고 어떻게 검증해야 하는지: JSON Schema로 데이터 계약을 정의하고(키 type, properties, required, format), Java에서 everit-org/json-schema 라이브러리로 검증( Schema로 스키마 로드, validate 호출), ValidationException을 올바르게 처리해 사용자와 API를 위한 이해하기 쉬운 오류 메시지를 만든다.