케이스 클래스으로 디코딩하기
JSON을 자신의 형식에 매핑해 보세요.
케이스 클래스으로 디코딩하기은(는) CoddyKit의 무료 Scala for Backend Engineering & Functional Programming 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Scala for Backend Engineering & Functional Programming 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Scala for Backend Engineering & Functional Programming 강의에는 총 4개의 강의가 포함되어 있습니다.
디코더로 JSON을 타입에 매핑하기
Decoder[A]는 Json 값을 Scala 타입 A로 읽는 방법을 알고 있습니다.
Circe는 기본 타입과 컬렉션용 디코더를 기본으로 제공하며, 사용자가 만든 케이스 클래스용 디코더도 자동으로 만들 수 있습니다.
대상 케이스 클래스
API가 사용자 기록을 반환한다고 가정해 보겠습니다. JSON 키와 필드 이름이 일치하는 케이스 클래스로 구조를 모델링하십시오.
이름이 일치해야 Circe가 수작업으로 연결하지 않고 디코더를 파생할 수 있습니다.
case class User(name: String, age: Int, admin: Boolean)자동 파생
io.circe.generic.auto._를 가져오면 필요한 곳에서 Circe가 암시적으로 Decoder[User]를 필요할 때마다 파생합니다.
그 후에는 추가적인 반복 코드 없이 decode[User]를 호출하면 됩니다.
import io.circe.generic.auto._
import io.circe.parser.decode
val json = "{\"name\":\"Ada\",\"age\":36,\"admin\":true}"
val user = decode[User](json)
println(user) // Right(User(Ada,36,true))반자동 파생
컴파일 시간을 줄이고 명시적으로 제어하려면 io.circe.generic.semiauto.deriveDecoder를 사용하십시오.
일반적으로 컴패니언 객체에서 디코더를 한 번 정의한 뒤, 모든 곳에서 같은 인스턴스를 재사용합니다.
import io.circe.Decoder
import io.circe.generic.semiauto._
object User {
implicit val dec: Decoder[User] = deriveDecoder[User]
}디코딩 실패
필수 필드가 없거나 타입이 잘못되면 DecodingFailure와 함께 디코딩이 실패합니다.
실패 정보에는 커서 연산의 이력이 담겨 어느 필드가 문제를 일으켰는지 정확히 알려 줍니다.
val bad = decode[User]("{\"name\":\"Ada\"}")
println(bad)
// Left(DecodingFailure at .age: Missing required field)클래스의 선택적 필드
JSON 키가 없거나 null일 수 있는 필드는 Option[A]으로 만드십시오.
Circe는 누락된 키를 자동으로 None으로 디코딩하므로 선택적 필드라는 이유만으로 사용자 지정 디코더를 만들 필요가 없습니다.
case class Account(id: Long, nickname: Option[String])
val a = decode[Account]("{\"id\":7}")
println(a) // Right(Account(7,None))기본값
케이스 클래스의 기본값은 누락된 JSON 키를 채울 수 있지만, 기본값을 활성화한 configured 파생 방식을 사용할 때만 가능합니다.
circe-generic-extras 모듈은 Configuration.default.withDefaults를 통해 이 기능을 제공합니다.
import io.circe.generic.extras._
implicit val cfg: Configuration =
Configuration.default.withDefaults
@ConfiguredJsonCodec
case class Settings(theme: String = "dark")중첩된 케이스 클래스
디코딩은 조합됩니다. Circe가 각 필드의 타입을 디코딩할 수 있다면, 다른 케이스 클래스를 포함하는 클래스도 디코딩할 수 있습니다.
파생은 자동으로 재귀하므로 import 하나만으로 깊게 중첩된 구조를 처리할 수 있습니다.
case class Address(city: String)
case class Person(name: String, address: Address)
val p = decode[Person](
"{\"name\":\"Ada\",\"address\":{\"city\":\"London\"}}")
println(p)필드 이름 바꾸기
JSON 키가 Scala 이름과 다를 때(예: snake_case) Configuration.default.withSnakeCaseMemberNames를 사용하는 구성된 파생 방식을 사용하십시오.
이렇게 하면 수작업으로 디코더를 작성하지 않고도 created_at을 Scala 필드 createdAt으로 매핑할 수 있습니다.
import io.circe.generic.extras._
implicit val cfg: Configuration =
Configuration.default.withSnakeCaseMemberNames
@ConfiguredJsonCodec
case class Event(createdAt: String)오류 누적하기
기본적으로 디코딩은 첫 번째 오류에서 즉시 실패합니다. 반면 decodeAccumulating은 모든 실패를 ValidatedNel에 모읍니다.
이는 모든 문제를 한 번에 보고해야 하는 양식 검증에 유용합니다.
import io.circe.Decoder
val result = Decoder[User]
.decodeAccumulating(json.hcursor)
// Validated[NonEmptyList[DecodingFailure], User]파생 방식 선택하기
빠른 프로토타입에는 auto를, 고정된 인스턴스와 더 빠른 컴파일을 원하는 실제 코드에는 semiauto를 사용하십시오.
이름 변경, 기본값 또는 판별자가 필요할 때는 generic-extras를 사용하십시오.
빠른 확인
케이스 클래스로 디코딩하는 방법을 제대로 이해했는지 확인해 보십시오.
복습
Decoder[A]는 JSON을 타입이 지정된 값으로 변환합니다. 키와 이름이 일치하는 케이스 클래스에는 generic.auto 또는 semiauto.deriveDecoder를 사용하십시오.
누락된 키는 Option 필드를 None으로 디코딩하고, generic-extras는 기본값과 이름 변경 기능을 추가하며, decodeAccumulating은 모든 오류를 모읍니다.
자주 묻는 질문
“케이스 클래스으로 디코딩하기” 강의는 무료인가요?
네 — “케이스 클래스으로 디코딩하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Scala for Backend Engineering & Functional Programming 강의 전체를 잠금 해제할 수 있습니다. Scala for Backend Engineering & Functional Programming 강의에는 총 4개의 강의가 포함되어 있습니다.
“케이스 클래스으로 디코딩하기”에서 뭘 배우나요?
JSON을 자신의 형식에 매핑해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Scala for Backend Engineering & Functional Programming을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Scala for Backend Engineering & Functional Programming을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Scala for Backend Engineering & Functional Programming은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“케이스 클래스으로 디코딩하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Scala for Backend Engineering & Functional Programming 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Scala for Backend Engineering & Functional Programming 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- JSON 구문 분석
- 케이스 클래스으로 디코딩하기
- JSON으로 인코딩하기
- 사용자 지정 코덱