dio

HTTP 요청 처리 및 인터셉터를 지원하는 Dart 언어 기반 라이브러리

Flutter에서 Dio는 강력하고 유연한 HTTP 네트워킹 라이브러리입니다. Dio를 사용하면 HTTP 요청을 쉽게 만들고 수정할 수 있습니다. 이 라이브러리는 GET, POST, PUT, DELETE 등의 모든 HTTP 메소드를 지원하며, 쿠키 관리, 파일 업로드 및 다운로드, 요청 취소, 요청 타임아웃 등의 고급 기능도 제공합니다.

주요기능

•

HTTP  요청 처리

•

인터셉터

•

쿠키 관리

•

파일 업로드 및 다운로드

•

요청 취소 및 타임아웃 설정

의존성

dio | Dart Package

A powerful HTTP networking package, supports Interceptors, Aborting and canceling a request, Custom adapters, Transformers, etc.

https://pub.dev/packages/dio/install

Dart install 명령어

dart pub add dio
Dart
복사

Flutter install 명령어

flutter pub add dio
Dart
복사

pubspec.yaml

dependencies:
  dio: ^5.8.0+1
Dart
복사

import

import 'package:dio/dio.dart';
Dart
복사

기본 예시코드

import 'package:dio/dio.dart';

void fetchData() async {
  Dio dio = Dio();

  try {
    Response response = await dio.get('https://api.example.com/data');
    print(response.data);
  } catch (error) {
    print('Error: $error');
  }
}
Dart
복사

dio 주요 메소드

메소드

기능	주요 메소드
GET	dio.get(url, {options, cancelToken, onReceiveProgress})
POST	dio.post(url, data, {options, cancelToken, onSendProgress, onReceiveProgress})
PUT	dio.put(url, data, {options, cancelToken, onSendProgress, onReceiveProgress})
DELETE	dio.delete(url, {data, options, cancelToken})

메소드 인자(parameters)

속성	설명
data	POST 및 PUT 요청에서 전송할 데이터를 지정
options	요청에 대한 다양한 설정을 포함하는 옵션 객체
cancelToken	요청을 취소할 때 사용되는 토큰
onSendProgress	업로드 진행 상황을 추적하는 콜백 함수
onReceiveProgress	다운로드 진행 상황을 추적하는 콜백 함수

요청 메소드 별 예시코드

•

get()

•

post()

•

put()

•

delete()

get()

import 'package:dio/dio.dart';

void fetchData() async {
  Dio dio = Dio();

  try {
    Response response = await dio.get('https://api.example.com/data');
    print(response.data);
  } catch (error) {
    print('Error: $error');
  }
}
Dart
복사

post()

import 'package:dio/dio.dart';

void postData() async {
  Dio dio = Dio();
  Map<String, dynamic> data = {
    'username': 'john_doe',
    'email': 'john@example.com',
  };

  try {
    Response response = await dio.post('https://api.example.com/users', data: data);
    print(response.data);
  } catch (error) {
    print('Error: $error');
  }
}
Dart
복사

put()

import 'package:dio/dio.dart';

void updateData() async {
  Dio dio = Dio();
  Map<String, dynamic> data = {
    'username': 'john_doe_updated',
    'email': 'john@example.com',
  };

  try {
    Response response = await dio.put('https://api.example.com/users/1', data: data);
    print(response.data);
  } catch (error) {
    print('Error: $error');
  }
}
Dart
복사

delete()

import 'package:dio/dio.dart';

void deleteData() async {
  Dio dio = Dio();

  try {
    Response response = await dio.delete('https://api.example.com/users/1');
    print(response.data);
  } catch (error) {
    print('Error: $error');
  }
}
Dart
복사

http vs dio

Dart에서 HTTP 요청을 수행할 때 http 패키지와 dio 패키지는 가장 많이 사용되는 라이브러리입니다. 각각의 차이점을 표로 정리해 보겠습니다.

http vs dio 비교 표

항목	http 패키지	dio 패키지
설치	dart pub add http	dart pub add dio
사용 방식	기본적인 HTTP 요청 지원	강력한 기능을 갖춘 HTTP 클라이언트
JSON 변환	수동으로 jsonDecode() 사용	자동으로 JSON 변환 지원
요청/응답 인터셉터	없음	요청/응답 인터셉터 지원
타임아웃 설정	없음	connectTimeout, receiveTimeout 제공
FormData 지원	multipart 방식 사용	FormData 클래스 제공
파일 업로드	직접 multipart/form-data 구현	FormData와 onSendProgress 지원
스트림 지원	http.StreamedRequest 사용	기본적으로 스트림을 지원
취소 기능	지원하지 않음	CancelToken을 사용해 요청 취소 가능
에러 처리	단순한 try-catch 사용	상세한 예외 및 에러 핸들링 지원

어떤 경우에 사용해야 할까?

•

http 패키지

◦

간단한 REST API 호출만 필요한 경우

◦

패키지 크기를 최소화해야 하는 경우

•

dio 패키지

◦

인터셉터, 타임아웃, 요청 취소, 파일 업로드 등이 필요한 경우

◦

JSON 변환과 같은 편의 기능을 활용하고 싶은 경우

http는 가볍고 간단하지만, dio는 더 강력한 기능을 제공합니다. 프로젝트의 요구사항에 따라 선택하면 됩니다!