Dart 튜토리얼 12편: 데이터 변환(dart:convert·JSON·숫자 표현)

Why#

NOTE

JSON 문자열을 그대로 다루면, “키가 있는지/타입이 맞는지”를 매번 추측해야 합니다.
먼저 jsonDecode()로 구조를 만들고, 그 구조를 기준으로 다음 작업을 진행하는 편이 안전합니다.

1
import 'dart:convert';
2

3
var jsonString = '''
4
  [
5
    {"score": 40},
6
    {"score": 80}
7
  ]
8
''';
9

10
var scores = jsonDecode(jsonString);

What#

NOTE

jsonDecode()는 JSON 텍스트를 Dart 객체(리스트/맵 등)로 바꿉니다.
입력의 최상위가 배열이면 List, 객체면 Map 형태로 나옵니다.

How#

TIP

디코딩 결과를 “무슨 구조인지” 확인하고 다음 로직을 붙입니다.

1
var scores = jsonDecode(jsonString);
2
assert(scores is List);
3

4
var firstScore = scores[0];
5
assert(firstScore is Map);
6
assert(firstScore['score'] == 40);

Watch out#

WARNING

JSON 문자열은 문자열 규칙이 Dart 코드 문자열과 다릅니다.
예시처럼 JSON 내부 문자열은 큰따옴표를 사용해야 합니다.

1
// JSON 문자열 내부는 큰따옴표(")를 사용한다.
2
var jsonString = '''
3
  [
4
    {"score": 40}
5
  ]
6
''';

결론: 입력은 jsonDecode()로 “구조를 먼저 고정”하면, 이후 단계가 안정됩니다.

Why#

NOTE

내부에서 쓰는 데이터 구조를 그대로 외부에 내보내면, 출력 형식이 흔들릴 수 있습니다.
그래서 출력은 jsonEncode()로 “최종 텍스트”를 한 번에 만드는 편이 안전합니다.

1
var scores = [
2
  {'score': 40},
3
  {'score': 80},
4
];
5
var jsonText = jsonEncode(scores);

What#

NOTE

jsonEncode()는 Dart 객체를 JSON 문자열로 인코딩합니다.
null¹¹ 같은 값도 JSON의 null로 표현됩니다.

How#

TIP

리스트/맵을 만들고 jsonEncode()로 변환합니다.

1
var scores = [
2
  {'score': 40},
3
  {'score': 80},
4
  {'score': 100, 'overtime': true, 'special_guest': null},
5
];
6

7
var jsonText = jsonEncode(scores);
8
assert(
9
  jsonText ==
10
      '[{"score":40},{"score":80},'
11
          '{"score":100,"overtime":true,'
12
          '"special_guest":null}]',
13
);

Watch out#

WARNING

인코딩 결과는 “텍스트”이기 때문에, 출력 비교를 엄격하게 할 때는 공백/순서까지 포함해 달라질 수 있습니다.
즉, 문자열 비교가 목적이라면 “비교 기준(정규화)”을 먼저 정하는 편이 안전합니다.

결론: 출력은 jsonEncode()로 “한 번에” 만들고, 비교는 기준을 정해둡니다.

Why#

NOTE

파일/네트워크는 바이트(List<int>)로 흘러오는 경우가 많습니다.
이 바이트를 문자열로 바꾸려면 UTF-8 디코딩이 필요합니다.

1
import 'dart:convert';
2

3
List<int> utf8Bytes = [
4
  0xc3, 0x8e, 0xc3, 0xb1, 0xc5, 0xa3, 0xc3, 0xa9,
5
  0x72, 0xc3, 0xb1, 0xc3, 0xa5, 0xc5, 0xa3, 0xc3,
6
  0xae, 0xc3, 0xb6, 0xc3, 0xb1, 0xc3, 0xa5, 0xc4,
7
  0xbc, 0xc3, 0xae, 0xc5, 0xbe, 0xc3, 0xa5, 0xc5,
8
  0xa3, 0xc3, 0xae, 0xe1, 0xbb, 0x9d, 0xc3, 0xb1,
9
];

What#

NOTE

utf8는 UTF-8 인코딩을 처리하는 코덱입니다.
utf8.decode()¹²로 바이트 → 문자열, utf8.encode()¹³로 문자열 → 바이트를 처리합니다.

How#

TIP

바이트 리스트를 문자열로 디코딩합니다.

1
var funnyWord = utf8.decode(utf8Bytes);
2
assert(funnyWord == 'Îñţérñåţîöñåļîžåţîờñ');

문자열을 다시 바이트로 인코딩할 수도 있습니다.

1
var encoded = utf8.encode('Îñţérñåţîöñåļîžåţîờñ');
2
assert(encoded.length == utf8Bytes.length);
3
for (var i = 0; i < encoded.length; i++) {
4
  assert(encoded[i] == utf8Bytes[i]);
5
}

바이트 스트림을 줄 단위로 읽고 싶다면 utf8.decoder와 LineSplitter¹⁴를 조합합니다.

1
var lines = utf8.decoder.bind(inputStream).transform(const LineSplitter());
2
try {
3
  await for (final line in lines) {
4
    print('Got ${line.length} characters from stream');
5
  }
6
  print('file is now closed');
7
} catch (e) {
8
  print(e);
9
}

Watch out#

WARNING

UTF-8 디코딩은 “바이트가 어떤 인코딩인지”가 전제입니다.
즉, 입력이 UTF-8이 아니라면 결과가 깨질 수 있습니다.

결론: 바이트를 문자열로 바꾸는 순간이 핵심이므로, utf8 흐름을 코드로 고정합니다.

Why#

NOTE

숫자 자체는 같아도, 문자열로 만들면 표현이 달라질 수 있습니다.
그래서 “숫자 → 문자열”은 테스트/비교에서 특히 조심해야 합니다.

1
void main() {
2
  var count = 10.0 * 2;
3
  var message = "$count cows";
4
  if (message != "20.0 cows") throw Exception("Unexpected: $message");
5
}

What#

NOTE

숫자(num¹⁵/int¹⁶/double)가 문자열로 들어가는 순간, 표현 규칙이 개입합니다.
따라서 비교 기준을 “값 비교”로 할지, “문자열 비교”로 할지 먼저 정해야 합니다.

How#

TIP

문자열 비교가 필요한 경우, 문자열 템플릿을 명시하는 방식으로 비교 기준을 고정할 수 있습니다.

1
if (message != "${20.0} cows") throw ...;

Watch out#

WARNING

숫자 표현 문제는 JSON에도 전파될 수 있습니다.
즉, 화면/로그/테스트에서 “숫자 문자열이 항상 같은 형태일 것”을 전제로 두지 않는 편이 안전합니다.

결론: 숫자는 값 자체보다 “표현(문자열/JSON)”에서 더 자주 문제를 만든다는 관점이 필요합니다.