JSON to Dart 변환기

JSON이 Null Safety Dart 모델로 변환되는 방식

Dart 공식 dart:convert 문서에 따르면 jsonDecode()는 숫자, 문자열, Boolean, null, 리스트, 문자열 키를 가진 맵 등 JSON과 호환되는 값을 반환합니다. 모델 클래스 자체는 바로 JSON으로 인코딩할 수 없지만, jsonEncode()가 클래스의 toJson() 메서드를 호출하도록 만들 수 있습니다. 이 변환기는 json_serializable 어노테이션이나 패키지 의존성 없이 이러한 수동 직렬화 패턴을 생성합니다.

예를 들어 예제에 중첩된 주소를 가진 사용자가 있다고 가정해 보겠습니다. 생성된 User에는 final 필드와 명명된 매개변수 생성자가 포함됩니다. User.fromJson(Map<String, Object?> json)은 스칼라 값을 캐스팅하고 중첩 객체에는 UserAddress.fromJson()을 호출합니다. 예제 객체 중 하나라도 address가 없거나 null이면 타입은 UserAddress?가 되고, 팩토리는 객체를 만들기 전에 null을 확인합니다. toJson을 켜면 중첩 모델도 재귀적으로 jsonEncode()가 처리할 수 있는 맵으로 변환됩니다.

변환기는 루트 배열의 첫 항목만 믿지 않고 모든 객체를 확인합니다. 어떤 항목에서 필드가 빠져 있거나 값이 명시적으로 null이면 해당 필드는 nullable이 됩니다. 실제 API가 예제보다 불규칙하다면 모든 필드를 nullable로 만들 수도 있습니다. Dart Null Safety 안내서에서 설명하듯 타입은 기본적으로 null을 허용하지 않으며, null을 받으려면 ?가 필요합니다.

식별자 처리와 추론의 한계

JSON 키는 올바른 Dart 멤버 이름일 필요가 없습니다. 구두점을 제거하고 단어를 lowerCamelCase로 바꾸며, 예약어에는 안전한 접미사를 붙입니다. 이름이 충돌하면 결과가 매번 같도록 숫자 접미사를 추가합니다. 원래 키는 json['original-key']와 toJson() 맵에 그대로 유지됩니다. 중첩 클래스 이름에는 전체 경로를 사용하므로 서로 관련 없는 주소 객체가 조용히 하나의 클래스로 합쳐지지 않습니다.

예제 하나만으로 API 계약 전체를 확정할 수는 없습니다. JSON 문자열은 날짜, UUID, enum으로 자동 인식되지 않으며 빈 배열에서는 요소 타입을 알 수 없습니다. 객체 멤버 이름이 중복되면 JSON 파서가 일반적으로 마지막 값만 보존하므로 왕복 변환의 안전성도 보장할 수 없습니다. 운영 환경에서 사용하기 전에 생성된 모델을 API 문서나 스키마와 대조하세요. 브라우저 작업량을 제한하기 위해 입력 크기, 중첩 깊이, 추론되는 선언 수, 출력 크기에는 상한이 적용됩니다.