Dart Academy · 강의

json_serializable 활용하기

모델 직렬화를 자동으로 생성합니다

레슨 4/413개 단계

json_serializable 활용하기은(는) CoddyKit의 무료 Dart Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Dart Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Dart Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

JSON 상용구 코드 문제

fromJson과 toJson을 직접 작성하는 일은 번거롭고 오류가 발생하기 쉽습니다. json_serializable 패키지는 모델을 바탕으로 두 코드를 모두 생성해 줍니다. 📦

패키지 추가

일반 의존성으로 json_annotation이 필요하고, 생성을 위해 json_serializable과 build_runner를 개발 의존성으로 추가해야 합니다.

dependencies:
  json_annotation: ^4.9.0

클래스에 주석 달기

모델에 @JsonSerializable을 표시합니다. 이 주석은 생성기에게 해당 class의 직렬화 코드를 만들도록 지시합니다.

@JsonSerializable()
class User {
  final String name;
  User(this.name);
}

파트 파일 선언

생성된 도우미를 파일에 포함할 수 있도록 part 지시문을 추가합니다. 이름은 파일 이름에 .g.dart 접미사를 붙인 형태입니다.

part 'user.g.dart';

fromJson 연결

생성된 함수를 전달하는 팩토리를 추가합니다. _$UserFromJson 도우미는 빌더가 대신 만들어 줍니다.

factory User.fromJson(Map<String, dynamic> j) =>
    _$UserFromJson(j);

toJson 연결

생성된 작성 함수를 호출하는 메서드를 추가합니다. _$UserToJson 도우미는 객체를 다시 JSON 맵으로 변환합니다.

Map<String, dynamic> toJson() => _$UserToJson(this);

코드 생성

build_runner를 한 번 실행하면 user.g.dart 파일이 생성되고, 두 도우미 함수가 완전히 구현되어 바로 사용할 수 있게 됩니다.

dart run build_runner build

JSON 키 이름 변경

API 필드 이름이 Dart 이름과 다를 때는 @JsonKey를 사용해 매핑합니다. 코드는 깔끔하게 유지하면서 JSON은 서버 형식에 맞출 수 있습니다.

@JsonKey(name: 'full_name')
final String fullName;

기본값 제공

누락된 필드에 사용할 대체값을 지정할 수 있습니다. defaultValue 옵션은 JSON에 키가 없을 때 값을 채워 넣습니다.

@JsonKey(defaultValue: 0)
final int score;

중첩 모델도 자동으로 처리됩니다

필드가 다른 @JsonSerializable class라면 생성기가 재귀적으로 직렬화합니다. 중첩 객체를 위해 별도의 작업을 할 필요가 없습니다.

일반 Dart처럼 사용하기

생성이 끝나면 일반적인 메서드 호출만으로 파싱하고 인코딩할 수 있습니다. 생성된 helpers는 내부에 숨겨져 호출부가 자연스럽게 읽힙니다.

final u = User.fromJson(data);
final back = u.toJson();

빠른 확인

JSON 코드 생성을 위해 class를 표시하는 주석은 무엇인가요?

인터랙티브 레슨에서 답해보세요

복습

@JsonSerializable을 추가하고 fromJson과 toJson을 연결한 다음 build_runner를 실행하세요. @JsonKey로 필드 이름과 기본값을 매핑할 수 있습니다. 🎉

무료로 시작

AI 튜터와 함께 Dart을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 30
레슨: 120

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“json_serializable 활용하기” 강의는 무료인가요?

네 — “json_serializable 활용하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Dart Academy 강의 전체를 잠금 해제할 수 있습니다. Dart Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“json_serializable 활용하기”에서 뭘 배우나요?

모델 직렬화를 자동으로 생성합니다 브라우저에서 직접 실행하는 실습 코드로 Dart Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Dart Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Dart Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“json_serializable 활용하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Dart Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Dart Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Dart Academy(으)로 돌아가기