ربط فلاتر بالخادم باستخدام Dio: النماذج والأخطاء والبنية النظيفة
كل تطبيق حقيقي يتواصل مع واجهة API. يوضح هذا الدليل كيف ترسل الطلبات باستخدام Dio، وتحوّل الاستجابات إلى نماذج Dart، وتعالج الأخطاء بشكل صحيح، وتُبقي شيفرة الشبكة في طبقة نظيفة.
مع نمو التطبيق تتفكك الشيفرة دون بنية. يشرح هذا المقال تنظيم المجلدات حسب الميزة، وطبقات الواجهة والحالة والمستودع ومصدر البيانات، ومبادئ قابلية الاختبار بلغة بسيطة.

التطبيقات الصغيرة تتسع لبضعة ملفات. لكن حين يكبر التطبيق ويعمل عليه عدة أشخاص، يصبح كل تغيير بسيط مخاطرة دون بنية. العمارة النظيفة تعني أن لكل جزء من الشيفرة مسؤولية واحدة واضحة.
بدل التجميع حسب نوع الملف (كل العناصر معًا، وكل النماذج معًا)، جمّع حسب الميزة:
lib/
core/ # shared: network, theme, utils
features/
auth/
data/ # api + repository implementation
domain/ # models + repository interface
presentation/# screens, widgets, controllers
courses/
data/
domain/
presentation/
main.dartالفائدة: للعمل على ميزة تبحث في مجلد واحد، ويصبح حذف ميزة أو نقلها سهلًا.
abstract class CourseRepository {
Future<List<Course>> fetchCourses();
}
class ApiCourseRepository implements CourseRepository {
ApiCourseRepository(this._api);
final CourseApi _api;
@override
Future<List<Course>> fetchCourses() => _api.getCourses();
}لماذا واجهة؟ في الاختبارات تضع FakeCourseRepository وتختبر سلوك الشاشة دون إنترنت.
يجب ألا تبني الأصناف اعتمادياتها بنفسها؛ بل تستلمها. عبر المُنشئات أو Riverpod:
final courseRepositoryProvider = Provider<CourseRepository>(
(ref) => ApiCourseRepository(ref.watch(courseApiProvider)),
);عرّف النماذج بحقول final ومُنشئات const، وأنشئ نسخة جديدة لتغيير أي شيء (copyWith). هذا يقضي على الأخطاء الناتجة عن التغيير الخفي.
تطبيق من ثلاث شاشات لا يحتاج إلى أربع طبقات. ابدأ ببساطة وأضف الطبقات عندما تشعر بالحاجة. يجب أن تمنحك العمارة سرعة لا أن تبطئك.
إذا خرجت بشيء واحد فليكن: افصل الواجهة عن المنطق والبيانات. وكل شيء آخر يبدأ من هنا.
يبني فريق فست فلاتر تطبيقات أندرويد وiOS والويب وسطح المكتب والمواقع بفلاتر: تقدير فوري بالدولار، ودفع على مراحل، والشيفرة المصدرية كاملة.