중급

네트워크와 API

REST API 호출, JSON 파싱, 오류 처리, 로딩 상태를 다룹니다.

개념 먼저 보기

네트워크와 API의 기본 개념부터 잡기

네트워크와 API 문서는 먼저 용어의 뜻을 잡고, 그 다음 Flutter 코드에서 어디에 쓰이는지 연결해서 읽는 것이 좋습니다.

아래 항목들은 이 문서에서 다루는 내용을 작은 단위로 나눈 것입니다. 각 항목을 읽은 뒤 예제를 보면 코드가 훨씬 덜 추상적으로 느껴집니다.

종류별로 하나씩

네트워크와 API에서 나눠 볼 핵심 요소

API 호출

http 또는 dio 패키지로 서버와 통신합니다.

언제 쓰나: 응답 코드는 성공, 인증 실패, 서버 오류를 구분하는 기준입니다.

Flutter에서: 네트워크 계층은 UI와 분리해 테스트 가능하게 유지합니다.

// 네트워크와 API 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
factory Lesson.fromJson(Map<String, dynamic> json) {
  return Lesson(title: json['title'] as String);
}

모델 변환

JSON을 Map으로만 다루면 런타임 오류가 숨어들기 쉽습니다.

언제 쓰나: fromJson과 toJson을 가진 모델 클래스로 변환하면 안전합니다.

Flutter에서: 서버 응답 변경에 대비해 nullable과 기본값을 신중하게 설계합니다.

// 네트워크와 API 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
factory Lesson.fromJson(Map<String, dynamic> json) {
  return Lesson(title: json['title'] as String);
}

부연 설명

API 호출

http 또는 dio 패키지로 서버와 통신합니다.
응답 코드는 성공, 인증 실패, 서버 오류를 구분하는 기준입니다.
네트워크 계층은 UI와 분리해 테스트 가능하게 유지합니다.

부연 설명

모델 변환

JSON을 Map으로만 다루면 런타임 오류가 숨어들기 쉽습니다.
fromJson과 toJson을 가진 모델 클래스로 변환하면 안전합니다.
서버 응답 변경에 대비해 nullable과 기본값을 신중하게 설계합니다.

깊게 이해하기

네트워크와 API 문서는 Flutter 앱을 만들 때 반복해서 마주치는 개념을 독립적으로 정리한 페이지입니다. 먼저 용어의 의미를 잡고, 그 다음 실제 코드에서 어디에 배치되는지 연결해 보면 학습 속도가 빨라집니다.

이 주제는 단독으로 외우기보다 앞뒤 문서와 함께 보는 것이 좋습니다. 예를 들어 문법 주제는 위젯 코드에서 어떻게 드러나는지, 배포 주제는 실제 앱 운영 흐름에서 어떤 결정을 요구하는지 함께 확인하세요.

상세 예제

아래 예제는 이 문서의 핵심 개념을 실제 프로젝트에서 작은 단위로 적용하는 형태입니다.

factory Lesson.fromJson(Map<String, dynamic> json) {
  return Lesson(title: json['title'] as String);
}

실무에서 주의할 점

처음에는 가장 단순한 구현으로 시작하고, 반복되는 시점에 구조를 정리하세요.
예제 코드를 그대로 외우기보다 입력, 출력, 책임을 나누어 읽어 보세요.
새 문서를 추가할 때는 같은 형식으로 요약, 핵심 설명, 예제, 체크리스트를 유지하세요.

실습 체크리스트

API 클라이언트 만들기fromJson 작성로딩/오류 UI 표현

JSON 모델

factory Lesson.fromJson(Map<String, dynamic> json) {
  return Lesson(title: json['title'] as String);
}