Dart 튜토리얼 13편: 파일·네트워크 I/O(dart:io·HTTP fetch)

Why#

NOTE

설정 파일처럼 작은 텍스트 파일은 전체를 한 번에 읽어도 부담이 적고, 로직을 단순하게 시작할 수 있습니다.

1
import 'dart:io';
2

3
void main() async {
4
  var config = File('config.txt');
5

6
  // 파일을 문자열 하나로 읽는다.
7
  var stringContents = await config.readAsString();
8
  print('The file is ${stringContents.length} characters long.');
9

10
  // 파일을 “줄 단위 문자열 리스트”로 읽는다.
11
  var lines = await config.readAsLines();
12
  print('The file is ${lines.length} lines long.');
13
}

What#

NOTE

File¹⁶의 readAsString()과 readAsLines()는 Future를 반환합니다.
즉, 파일을 읽는 동안에도 프로그램은 다른 작업을 진행할 수 있고, 결과는 “완료된 뒤”에 받게 됩니다.

How#

TIP

바이너리 파일(또는 텍스트라도 바이트로 다루고 싶을 때)은 readAsBytes()¹⁷로 한 번에 읽습니다.

1
import 'dart:io';
2

3
void main() async {
4
  var config = File('config.txt');
5

6
  var contents = await config.readAsBytes();
7
  print('The file is ${contents.length} bytes long.');
8
}

Watch out#

WARNING

파일이 없거나 권한이 없으면 예외가 발생할 수 있습니다.
에러가 “잡히지 않은 예외”로 튀지 않게 try/catch로 묶어둡니다.

1
import 'dart:io';
2

3
void main() async {
4
  var config = File('config.txt');
5
  try {
6
    var contents = await config.readAsString();
7
    print(contents);
8
  } catch (e) {
9
    print(e);
10
  }
11
}

결론: 작은 파일은 “한 번에 읽기”로 시작하고, 항상 에러 처리를 함께 둡니다.

Why#

NOTE

파일이 크면 전체를 한 번에 메모리에 올리기 어렵습니다.
이때는 openRead()로 바이트 스트림을 만들고, 처리 가능한 단위(예: 줄)로 잘라가며 읽는 편이 안전합니다.

What#

NOTE

openRead()는 Stream<List<int>> 형태의 바이트 스트림을 반환합니다.
바이트를 텍스트로 바꾸려면 utf8.decoder¹⁸와 LineSplitter¹⁹ 같은 변환기를 스트림에 적용합니다.

How#

TIP

바이트 스트림을 줄 단위 문자열 스트림으로 바꾼 뒤, await for²⁰로 하나씩 처리합니다.

1
import 'dart:io';
2
import 'dart:convert';
3

4
void main() async {
5
  var config = File('config.txt');
6
  Stream<List<int>> inputStream = config.openRead();
7

8
  var lines = utf8.decoder.bind(inputStream).transform(const LineSplitter());
9
  try {
10
    await for (final line in lines) {
11
      print('Got ${line.length} characters from stream');
12
    }
13
    print('file is now closed');
14
  } catch (e) {
15
    print(e);
16
  }
17
}

Watch out#

WARNING

dart:io는 웹 앱에서는 사용할 수 없습니다.
웹이 아닌 Flutter 앱, 명령줄 스크립트, 서버에서만 사용할 수 있습니다.

결론: 큰 파일은 Stream으로 처리 단위를 정해 “조금씩” 처리합니다.

Why#

NOTE

로그처럼 “조금씩 계속 쓰는 출력”은 파일을 열고 반복해서 쓰는 흐름이 필요합니다.
이때 openWrite()로 IOSink²¹를 얻고, 마지막에 정리까지 해야 데이터가 안전하게 남습니다.

What#

NOTE

openWrite()는 파일에 쓰기 위한 IOSink를 제공합니다.
기본 모드는 FileMode.write²²로 기존 내용을 덮어쓰며, 이어쓰기라면 FileMode.append²³를 사용합니다.

How#

TIP

파일에 텍스트를 쓴 뒤 flush()²⁴와 close()²⁵로 마무리합니다.

1
import 'dart:io';
2

3
Future<void> writeLog() async {
4
  var logFile = File('log.txt');
5
  var sink = logFile.openWrite();
6
  sink.write('FILE ACCESSED ${DateTime.now()}\n');
7
  await sink.flush();
8
  await sink.close();
9
}

이어쓰기 모드도 같은 방식으로 시작합니다.

1
var sink = logFile.openWrite(mode: FileMode.append);

Watch out#

WARNING

close()를 호출하지 않으면, 버퍼에 남은 내용이 파일에 반영되지 않을 수 있습니다.
즉, “쓰기만 하고 끝”이 아니라, “마무리까지”를 코드로 고정해야 합니다.

결론: 출력은 IOSink로 쓰고, 마지막에 flush()/close()까지 끝냅니다.

Why#

NOTE

네트워크 요청은 실패가 흔합니다.
성공/실패를 구분하지 않고 본문만 쓰면, 에러 상황에서 잘못된 값이 조용히 흘러갈 수 있습니다.
그래서 응답 전체(Response)를 받고, statusCode로 성공 여부를 먼저 확인하는 흐름이 필요합니다.

What#

NOTE

package:http는 HTTP 요청을 위한 라이브러리입니다.
Uri로 URL을 만들고, http.get() 같은 함수로 요청을 보낸 뒤, Response에서 statusCode와 body를 사용합니다.

How#

TIP

먼저 의존성을 추가하고(dart pub add http), 가져온 데이터를 출력해 봅니다.

1
$ dart pub add http

1
import 'package:http/http.dart' as http;
2

3
void main() async {
4
  final httpPackageUrl = Uri.https('dart.dev', '/f/packages/http.json');
5
  final httpPackageResponse = await http.get(httpPackageUrl);
6
  if (httpPackageResponse.statusCode != 200) {
7
    print('Failed to retrieve the http package!');
8
    return;
9
  }
10
  print(httpPackageResponse.body);
11
}

필요하다면 headers를 Map<String, String> 형태로 함께 보낼 수 있습니다.

1
await http.get(
2
  Uri.https('dart.dev', '/f/packages/http.json'),
3
  headers: {'User-Agent': '<product name>/<product-version>'},
4
);

Watch out#

WARNING

HTTP 요청은 시간이 걸릴 수 있으므로 비동기(Future)로 동작합니다.
그리고 요청을 “여러 번” 보낼 때는 Client²⁶를 유지하고, 마지막에 close()²⁷로 정리하는 흐름이 제시됩니다.

1
import 'package:http/http.dart' as http;
2

3
void main() async {
4
  final httpPackageUrl = Uri.https('dart.dev', '/f/packages/http.json');
5
  final client = http.Client();
6
  try {
7
    final httpPackageInfo = await client.read(httpPackageUrl);
8
    print(httpPackageInfo);
9
  } finally {
10
    client.close();
11
  }
12
}

결론: HTTP는 Uri로 URL을 만들고, 응답의 statusCode를 먼저 확인하는 흐름으로 시작합니다.