فهرست مطالب
در این مقاله، به مقایسه فنی جامع دو کتابخانه محبوب HTTP در فلاتر، یعنی مقایسه Dio و Retrofit در فلاتر میپردازیم.
تفاوتها، مزایا و معایب آنها را بررسی کرده و به شما کمک میکنیم بهترین انتخاب را برای پروژه فلاتر خود داشته باشید.
با انتخاب درست کلاینت HTTP، عملکرد و توسعهپذیری برنامههای فلاتر خود را بهبود بخشید.
برای درک بهتر این آموزش نیاز هست تا با روش های ارتباط با سرور و به صورت کلی کار با وب سرویس ها آشنا باشید.
اگر در این زمینه هنوز شروع به کار نکرده اید میتوانید به مقاله آموزش ارتباط با سرور در فلاتر بپردازید.
مقدمه
در دنیای توسعه نرمافزار موبایل، ارتباط با APIهای وب، قلب تپنده هر برنامه است.
در اکوسیستم فلاتر، توسعهدهندگان گزینههای مختلفی برای مدیریت این تعاملات شبکه دارند.
در میان این گزینهها، دو کتابخانه برجسته و محبوبیت خاصی پیدا کردهاند: Retrofit و Dio. هر دو پکیج، قابلیتهای قدرتمندی برای مدیریت درخواستهای HTTP ارائه میدهند، اما رویکردها و نقاط قوت متفاوتی دارند.
این مقاله، یک مقایسه فنی عمیق بین Retrofit و Dio ارائه میدهد و به شما کمک میکند تا با درک تفاوتهای آنها، بهترین انتخاب را برای نیازهای پروژه فلاتر خود داشته باشید.
بیایید با این دو غول ارتباطات شبکه در فلاتر آشنا شویم.
رتروفیت (Retrofit) چیست؟
Retrofit، یک تایپسیف HTTP کلاینت قدرتمند برای دارت و فلاتر است که از مفاهیم محبوب Retrofit در اکوسیستم اندروید (جاوا/کاتلین) الهام گرفته است.
این کتابخانه بر پایه Code Generation (تولید کد) عمل میکند.
به این معنی که شما با استفاده از Annotationها (نشانهگذاریها)، اینترفیسهایی (interfaces) را برای تعریف API خود ایجاد میکنید، و سپس ابزار تولید کد Retrofit، پیادهسازیهای مورد نیاز برای فراخوانی آن APIها را به صورت خودکار ایجاد میکند.
این رویکرد، توسعهدهنده را از نوشتن کدهای تکراری نجات میدهد و امنیت نوع (Type Safety) را در طول توسعه تضمین میکند.
پیشتر در وبسایت فلاتر لرن آموزش کار با پکیج رتروفیت در فلاتر را تهیه کرده ایم.
ویژگیهای کلیدی Retrofit
تولید کد (Code Generation): با استفاده از `retrofit_generator` و `build_runner`، کلاینت API شما به صورت خودکار از اینترفیسهای نشانهگذاری شده تولید میشود.
امنیت نوع (Type Safety): درخواستها و پاسخها به صورت قوی (Strongly Typed) تعریف میشوند که خطاهای زمان کامپایل را کاهش میدهد.
قابلیتهای Serialize/Deserialize: با ترکیب با `json_serializable`، تبدیل مدلهای دارت به جیسون و بالعکس به سادگی انجام میشود.
پشتیبانی از Interceptor: قابلیت افزودن منطق سفارشی به درخواستها و پاسخها (مثلاً افزودن توکن احراز هویت یا لاگگیری).
مثال از رتروفیت در برنامه نویسی فلاتر
dart
// user_api.dart
import 'package:retrofit/retrofit.dart';
import 'package:dio/dio.dart';
part 'user_api.g.dart';
@RestApi(baseUrl: "https://65bd27d2b51f99e3ecdd820f.mockapi.io/api/v1/")
abstract class UserApi {
factory UserApi(Dio dio, {String baseUrl}) = _UserApi;
@GET("/users/{id}")
Future<User> getUser(@Path("id") int id);
@POST("/users")
Future<User> createUser(@Body() User user);
}
// user.dart (مثال مدل داده)
class User {
final int id;
final String name;
final String email;
User({required this.id, required this.name, required this.email});
factory User.fromJson(Map<String, dynamic> json) {
return User(
id: json['id'],
name: json['name'],
email: json['email'],
);
}
Map<String, dynamic> toJson() {
return {
'id': id,
'name': name,
'email': email,
};
}
}
DIO چیست؟
Dio یک پکیج HTTP کلاینت قدرتمند و انعطافپذیر برای فریمورک فلاتر است.
این پکیج، به دلیل ارائه یک API غنی و قابلیتهای پیشرفته، بسیار مورد توجه قرار گرفته است.
Dio بدون نیاز به تولید کد، قابلیتهای فراوانی را در اختیار توسعهدهنده قرار میدهد و به شما امکان میدهد تا با کمترین دردسر، عملیات شبکه پیچیده را انجام دهید.
ویژگیهای کلیدی DIO
API غنی و انعطافپذیر: ارائه ابزارهای گسترده برای مدیریت درخواستها، پاسخها و خطاها.
Interceptorها: یکی از برجستهترین ویژگیهای Dio، سیستم Interceptor قدرتمند آن است. این قابلیت به شما اجازه میدهد تا درخواستها و پاسخها را قبل از ارسال یا پس از دریافت، دستکاری یا لاگگیری کنید.
پشتیبانی از FormData: رسال دادههای چندبخشی (Multipart) و فایلها به سرور را بسیار آسان میکند.
لغو درخواست (Request Cancellation): امکان لغو درخواستهای در حال اجرا.
آپدیت پیشرفت (Progress Updates): دریافت وضعیت پیشرفت برای دانلود و آپلود فایل.
تبدیل کننده (Transformer): قابلیت تبدیل دادهها به فرمتهای مختلف (مانند JSON).
Client Adapter: پشتیبانی از آداپتورهای مختلف HTTP کلاینت (مانند HttpClient داخلی زبان دارت).
قبلا در وبسایت فلاتر لرن آموزش کار با پکیج Dio را تهیه کرده ایم.
مثال کد ساده Dio:
// dio_example.dart
import 'package:dio/dio.dart';
class ApiService {
final Dio _dio = Dio(BaseOptions(
baseUrl: 'https://65bd27d2b51f99e3ecdd820f.mockapi.io/api/v1/',
connectTimeout: Duration(milliseconds: 5000),
receiveTimeout: Duration(milliseconds: 3000),
));
ApiService() {
// افزودن Interceptor برای لاگگیری
_dio.interceptors.add(LogInterceptor(responseBody: true, requestBody: true));
}
Future<Map<String, dynamic>> getUser(int id) async {
try {
final response = await _dio.get('/users/$id');
return response.data;
} on DioException catch (e) {
// مدیریت خطا
print('خطا در دریافت کاربر: $e');
rethrow;
}
}
Future<Map<String, dynamic>> createUser(Map<String, dynamic> userData) async {
try {
final response = await _dio.post('/users', data: userData);
return response.data;
} on DioException catch (e) {
print('خطا در ایجاد کاربر: $e');
rethrow;
}
}
}
مقایسه Dio و Retrofit در فلاتر
حال که با هر دو کتابخانه آشنا شدیم، بیایید نگاهی عمیقتر به تفاوتهای اصلی آنها بیندازیم:
1) تولید کد در مقابل رویکرد بدون تولید کد
Retrofit: فلسفه اصلی Retrofit بر پایه **تولید کد** است.
شما اینترفیسهای خود را با Annotationها تعریف میکنید، و `retrofit_generator` کدهای لازم برای پیادهسازی اینترفیس را به صورت خودکار ایجاد میکند.
این رویکرد، امنیت نوع بالا و کاهش کدهای تکراری را به همراه دارد، اما نیاز به اجرای دستور `flutter pub run build_runner build` پس از هر تغییر در اینترفیسها را دارد.
Dioپکیج : Dio به صورت مستقیم و بدون نیاز به تولید کد عمل میکند.
شما به طور مستقیم از نمونه Dio برای ارسال درخواستها استفاده میکنید.
این رویکرد انعطافپذیری بیشتری در زمان اجرا فراهم میکند و نیازی به مرحله تولید کد ندارد، اما ممکن است کدهای boilerplate بیشتری برای سریالیزیشن/دیسریالیزیشن دستی دادهها نیاز باشد (مگر اینکه از json_serializable یا راهکارهای مشابه به صورت جداگانه استفاده کنید).
2) امنیت نوع (Type Safety)
Retrofit: به دلیل استفاده از تولید کد و اینترفیسهای Strongly Typed، امنیت نوع بسیار بالایی ارائه میدهد. خطاهای مربوط به نام متدها، پارامترها و انواع دادهها در زمان کامپایل شناسایی میشوند.
Dio: امنیت نوع آن به طور مستقیم توسط پکیج ارائه نمیشود.
شما مسئول مدیریت انواع دادهها و تبدیل JSON به مدلهای زبان دارت و بالعکس هستید.
اگرچه میتوانید با استفاده از کلاسها و متدهای `fromJson`/`toJson` خودتان امنیت نوع را پیادهسازی کنید، اما این مسئولیت بر عهده توسعهدهنده است.
3) Interceptorها
Retrofit: از سیستم Interceptor زیربنایی Dio استفاده میکند (زیرا Retrofit در فلاتر خود از Dio به عنوان کلاینت HTTP استفاده میکند).
بنابراین، قابلیتهای Interceptor آن در واقع همان قابلیتهای قدرتمند Dio است که از طریق `Dio` instance ارائه میشود.
Dio: دارای یک سیستم Interceptor بسیار غنی و انعطافپذیراست.
شما میتوانید Interceptorهای سفارشی برای انجام وظایفی مانند افزودن هدرهای احراز هویت، لاگگیری درخواستها، رفرش توکن، کش کردن و مدیریت خطاها تعریف کنید.
این قابلیت به Dio یک مزیت بزرگ در سناریوهای پیچیده میدهد.
4) مدیریت خطا
Retrofit: مدیریت خطا در Retrofit از طریق DioException (که در Dio تعریف شده است) انجام میشود، چرا که Retrofit بر پایه Dio ساخته شده است.
خطاها معمولاً با Catch کردن این اکشنها مدیریت میشوند.
Dio: پکیج Dio در فلاتر دارای یک کلاس DioException مفصل است که انواع مختلف خطاها (مانند خطای شبکه، خطای سرور، خطای timeout) را پوشش میدهد.
این ساختار، مدیریت و دستهبندی خطاها را آسانتر میکند.
5) آپلود و دانلود فایل
Retrofit: با توجه به اینکه Retrofit از Dio به عنوان لایه شبکه استفاده میکند، قابلیتهای آپلود و دانلود فایل را از Dio به ارث میبرد.
برای آپلود فایل، از MultipartFile و FormData در Dio استفاده میشود.
Dio: در زمینه آپلود و دانلود فایل بسیار قدرتمند و آسان است.
این پکیج، APIهای مشخصی برای ارسال دادههای FormData و دریافت وضعیت پیشرفت آپلود/دانلود ارائه میدهد که آن را به گزینهای عالی برای برنامههایی با نیاز به مدیریت فایل تبدیل میکند.
6) کارایی و عملکرد
هر دو کتابخانه عملکرد بسیار خوبی دارند و برای اکثر سناریوها مناسب هستند.
Retrofit: سربار تولید کد آن در زمان کامپایل اتفاق میافتد و در زمان اجرا، کد تولید شده بهینهسازی شده و کارآمد است.
Dio: بدون سربار تولید کد در زمان اجرا، اما در پروژههای بسیار بزرگ با تعداد زیادی API، ممکن است نیاز به کدهای تکراری بیشتری برای مدلسازی دادهها باشد که میتواند بر خوانایی و نگهداری تأثیر بگذارد.
7) جامعه و اکوسیستم
Retrofit: با الهام از Retrofit اندروید، توسعهدهندگان اندروید ممکن است با مفاهیم آن آشنایی بیشتری داشته باشند. جامعه آن در فلاتر در حال رشد است.
Dio: دارای یک جامعه کاربری بسیار بزرگ و فعال است.
مستندات عالی و مثالهای فراوانی در دسترس است که یافتن راهحلها و پشتیبانی را آسان میکند.
چه زمانی از کدام استفاده کنیم؟
انتخاب بین Retrofit و Dio به نیازها و ترجیحات خاص پروژه و تیم شما بستگی دارد:
از رتروفیت (Retrofit) استفاده کنید اگر:
امنیت نوع بالا (High Type Safety) اولویت شماست. اگر میخواهید مطمئن شوید که خطاهای مربوط به فراخوانی API در زمان کامپایل شناسایی میشوند.
از تولید کد (Code Generation) استقبال میکنید. اگر تمایل دارید که کدهای تکراری (boilerplate) را به صورت خودکار تولید کنید و از مزایای آن بهرهمند شوید.
از قبل با Retrofit در اکوسیستم اندروید آشنایی دارید. این امر میتواند منحنی یادگیری را کاهش دهد.
پروژه شما APIهای پیچیده و تعداد زیادی نقطه پایانی (Endpoints) دارد. تولید کد میتواند مدیریت این پیچیدگی را آسانتر کند.
از Dio استفاده کنید اگر:
نیاز به Interceptorهای قدرتمند و سفارشی دارید. Dio در این زمینه بیرقیب است و امکانات گستردهای برای لاگگیری، احراز هویت، کش و... فراهم میکند.
مدیریت آپلود و دانلود فایل با نمایش پیشرفت برای شما حیاتی است. Dio APIهای بسیار سادهای برای این کار ارائه میدهد.
ترجیح میدهید از تولید کد پرهیز کنید. اگر فرآیند تولید کد را یک سربار میدانید یا پروژه شما به قدری کوچک است که نیازی به آن ندارید.
به دنبال یک راه حل جامع و پرکاربرد هستید که جامعه کاربری بزرگی دارد. Dio برای اکثر سناریوها مناسب است.
هم Retrofit و هم Dio، هر دو کتابخانههای فوقالعادهای برای مدیریت درخواستهای HTTP در فلاتر هستند.
انتخاب بهترین گزینه به ماهیت پروژه، اندازه تیم و ترجیحات توسعهدهندگان بستگی دارد.
Retrofit برای پروژههای بزرگ با APIهای پیچیده که در آن امنیت نوع و کاهش کدهای boilerplate از طریق تولید کد اولویت دارد، میدرخشد.
Dio انعطافپذیری بینظیر، Interceptorهای قدرتمند و قابلیتهای مدیریت فایل پیشرفتهای را ارائه میدهد و برای اکثر پروژهها، به خصوص آنهایی که نیاز به کنترل دقیقتر بر عملیات شبکه دارند، یک انتخاب عالی است.
در نهایت، بسیاری از تیمها ممکن است از ترکیبی از این دو استفاده کنند یا رویکردی را انتخاب کنند که بهترین همخوانی را با سبک کدنویسی و نیازهای آنها دارد.
مهمترین چیز این است که ابزاری را انتخاب کنید که به شما کمک کند کدهای تمیزتر، قابل نگهداریتر و کارآمدتری بنویسید.
دیدگاهها (0)
دیدگاه خود را بنویسید