스칼라에서의 JSON 처리

1. 도입 (왜 배워야 하는가)

현대 소프트웨어 개발에서 데이터 교환 형식으로 JSON(JavaScript Object Notation)이 널리 사용됩니다. 특히 RESTful API와 웹 서비스에서 JSON은 서버와 클라이언트 간의 데이터 전송에 매우 중요한 역할을 합니다. 스칼라로 작성된 애플리케이션에서도 JSON을 처리하는 능력은 필수적입니다. JSON 처리 방법을 모르면 외부 시스템과의 데이터 통신이 제대로 이루어지지 않거나, 예기치 못한 오류가 발생할 수 있습니다. 따라서 스칼라에서 JSON을 효율적으로 처리하는 방법을 배우는 것은 개발자로서의 경쟁력을 높이는 중요한 요소입니다.

2. 핵심 개념 설명

JSON은 데이터의 구조를 표현하는 간단한 형식으로, 객체와 배열을 기반으로 합니다. 이를 통해 복잡한 데이터를 쉽게 표현할 수 있습니다.

주요 용어 정리

실생활 비유로 설명하자면, JSON은 마치 편지 봉투와 같습니다. 봉투 안에는 여러 가지 정보가 담길 수 있고(객체), 여러 봉투를 모아 하나의 상자에 넣을 수도 있습니다(배열). JSON을 이해하고 처리하는 것은 이러한 봉투를 열고 정보를 안전하게 읽고 쓸 수 있는 능력입니다.

3. 기본 코드 예제

스칼라에서 JSON을 처리하기 위해서는 circe라는 라이브러리를 사용할 수 있습니다. 다음은 JSON 문자열을 파싱하고 객체로 변환하는 기본 사용법입니다.

import io.circe._
import io.circe.parser._

val jsonString: String = """{"name": "Alice", "age": 30}""" // JSON 문자열 선언
val parsedJson: Either[ParsingFailure, Json] = parse(jsonString) // JSON 파싱

parsedJson match {
  case Right(json) => println(s"이름: ${json.hcursor.get[String]("name").getOrElse("unknown")}, 나이: ${json.hcursor.get[Int]("age").getOrElse(0)}")
  case Left(error) => println(s"파싱 오류: $error")
}

실행 결과

이름: Alice, 나이: 30

코드 한 줄씩 동작 설명

1. import io.circe._와 import io.circe.parser._: Circe 라이브러리의 JSON 관련 기능을 가져옵니다.
2. val jsonString: String = """{"name": "Alice", "age": 30}""": JSON 문자열을 정의합니다.
3. val parsedJson: Either[ParsingFailure, Json] = parse(jsonString): JSON 문자열을 파싱하여 Either 형태로 결과를 저장합니다. 성공 시 Json 객체, 실패 시 ParsingFailure를 반환합니다.
4. parsedJson match {...}: 파싱 결과에 따라 이름과 나이를 출력합니다. 성공 시 해당 값을 출력하고, 실패 시 오류 메시지를 출력합니다.

4. 실전 활용 예제

예제 1: REST API에서 데이터 가져오기

쇼핑몰의 장바구니 구현 시, 외부 API에서 상품 정보를 JSON 형식으로 가져와야 할 때가 있습니다.

import io.circe._
import io.circe.parser._
import scala.io.Source

val jsonResponse: String = Source.fromURL("http://api.example.com/products").mkString // API 호출
val parsedResponse = parse(jsonResponse)

parsedResponse match {
  case Right(json) =>
    val products = json.hcursor.downField("products").as[List[Product]] // Product 리스트로 변환
    // 추가 로직
  case Left(error) => println(s"API 호출 오류: $error")
}

예제 2: 데이터 직렬화

스칼라 객체를 JSON으로 변환하여 데이터베이스에 저장할 때 사용합니다.

import io.circe.syntax._

case class Product(name: String, price: Double)

val product = Product("Laptop", 999.99)
val jsonProduct = product.asJson // 객체를 JSON으로 변환
println(jsonProduct.noSpaces) // JSON 문자열 출력

5. 흔한 실수와 주의사항

실수 1: JSON 키 오타

잘못된 코드

json.hcursor.get[String]("naem") // 'name'이 아니라 'naem'으로 잘못 작성

올바른 코드

json.hcursor.get[String]("name") // 정확한 키 사용

실수 2: 파싱 결과 처리 누락

잘못된 코드

val invalidJson = parse("invalid json") // 잘못된 JSON
println(invalidJson.toOption.get) // None이 나오지만, 처리하지 않음

올바른 코드

invalidJson match {
  case Right(json) => println(json)
  case Left(error) => println(s"파싱 오류: $error") // 오류를 처리
}

6. 정리

• 스칼라에서 JSON은 데이터 교환을 위한 중요한 형식으로, 효율적인 처리가 필요합니다.
• Circe 라이브러리를 통해 JSON 파싱 및 직렬화가 가능하며, 이를 통해 다양한 데이터 소스를 다룰 수 있습니다.
• JSON 키 유효성과 파싱 결과 처리를 철저히 해야 합니다.

다음에 학습하면 좋은 주제:

• RESTful API 개발
• 스칼라에서 비동기 프로그래밍 (Future, Akka)
• 데이터베이스 연동 (Slick 사용법)