Rest Client Demo

Небольшой Dart-пакет с REST-клиентом на Dio. Он нормализует HTTP-ответы, преобразует ошибки в типизированные исключения, поддерживает multipart-запросы, загрузку файлов и Server-Sent Events.

Установка

dart pub get

Использование

import 'package:rest_client_demo/rest_client.dart';

final Dio dio = Dio(
  BaseOptions(
    baseUrl: 'https://api.example.com',
    connectTimeout: const Duration(seconds: 30),
    receiveTimeout: const Duration(seconds: 60),
  ),
);

dio.interceptors.add(LogInterceptor());

final RestClient client = DioRestClient(dio: dio);

try {
  final RestResponse response = await client.get(
    path: '/users',
    queryParams: {'page': 1},
  );
  final List<Object?> users = response.payload.dataAsList;
} on RestClientException catch (exception) {
  // Тип исключения и exception.messages определяют способ обработки ошибки.
}

Для отправки multipart-формы передайте RestContentType.formData в post, put или patch. Настройка авторизации, повторных запросов, логирования и мониторинга остаётся на стороне переданного экземпляра Dio.

Проверка

dart format .
dart analyze
dart test