شارك المقالة
Repository Pattern في Flutter لتنظيم API باستخدام Dio

Repository Pattern في Flutter لتنظيم API باستخدام Dio

نظّم API باستخدام Repository Pattern في Flutter، مع نماذج واضحة وحقن Dio ومعالجة الأخطاء دون طباعة رموز المصادقة أو إخفاء…

Repository Pattern في Flutter يفصل تفاصيل API عن الشاشة ويجعل الاختبار أسهل. المستودع لا يعيد نجاحًا لمجرد عدم حدوث exception، ولا يطبع Authorization أو بيانات الدخول. نستخدم Dio محقونًا في NewsRepository، ونحوّل الاستجابة إلى Article قبل أن تصل إلى الواجهة.

ملف عميل ونموذج ومستودع

الملف التالي مستقل لدرس الأخبار. يستخدم /news في خادمك الوسيط، بعقد يعيد articles، ولا يشير إلى خدمة منشورة جاهزة. اضبط baseUrl بنطاق API الفعلي قبل التجربة؛ لا تضع أسرار مزوّد الأخبار داخل تطبيق الهاتف لمجرد أنها لا تظهر في الشاشة.

import 'package:dio/dio.dart';

class Article {
  const Article(this.title, this.imageUrl);
  final String title;
  final String? imageUrl;
  factory Article.fromJson(Map<String, dynamic> json) {
    final rawTitle = json['title'];
    if (rawTitle is! String || rawTitle.trim().isEmpty) {
      throw const FormatException('Missing article title');
    }
    final rawImage = json['urlToImage'];
    final uri = rawImage is String ? Uri.tryParse(rawImage) : null;
    return Article(rawTitle, uri != null && uri.scheme == 'https' && uri.host.isNotEmpty
        ? uri.toString() : null);
  }
}

List<Article> parseArticles(Object? body) {
  if (body is! Map<String, dynamic> || body['articles'] is! List) {
    throw const FormatException('Invalid articles response');
  }
  return (body['articles'] as List).map((row) {
    if (row is! Map<String, dynamic>) {
      throw const FormatException('Invalid article row');
    }
    return Article.fromJson(row);
  }).toList(growable: false);
}

class NewsRepository {
  NewsRepository(this.dio);
  final Dio dio;
  // The backend owns provider credentials and returns {"articles": [...]}.
  Future<List<Article>> search(String query, {CancelToken? cancelToken}) async {
    final response = await dio.get<Object?>('/news',
        queryParameters: {'q': query}, cancelToken: cancelToken);
    return parseArticles(response.data);
  }
}

Dio createApiClient(String baseUrl) => Dio(BaseOptions(
  baseUrl: baseUrl,
  connectTimeout: const Duration(seconds: 10),
  receiveTimeout: const Duration(seconds: 15),
));

حقن الاعتمادات بدل المتغيرات العامة

أنشئ Dio مرة واحدة عبر createApiClient ثم مرره للمستودع. في الاختبار مرر عميلًا بمحول وهمي. لا تغير dio.options.headers عالميًا مع كل طلب من حساب مختلف؛ مرر الخيارات الخاصة بالطلب أو استخدم اعتراضًا واضح السياسة. لا تصلح عنوانًا يحتوي ?? باستبدال النص عشوائيًا؛ استخدم queryParameters ليجري الترميز بصورة صحيحة.

حدود مسؤولية المستودع

المستودع يحول بيانات النقل ويعرّف الأخطاء المتوقعة، بينما Cubit يحدد حالة التحميل والنجاح والفشل، وWidget يقرر العرض. لا تجمع تعريف interface وتنفيذ class داخل أقواس غير مكتملة في ملف واحد. يمكن فصل الملفات مع إبقاء أسماء واضحة بدل helpers تُعيد dynamic لكل العمليات.

معالجة الأخطاء دون إخفائها

استخدم runApi من درس معالجة الأخطاء إذا أردت نتيجة صريحة، أو مرر الاستثناء لطبقة تتعامل معه بوضوح. لا تحوّل فشل الخادم إلى قائمة فارغة؛ تلك القائمة قد تعني عدم وجود نتائج حقيقية. لا تعمل cast من Failure إلى ServerFailure دون فحص النوع، لأن فشل الكاش ليس بالضرورة فشل خادم.

اختبر شكل JSON الصحيح والخاطئ وطلبًا مرفوضًا ونتيجة فارغة. تحقق أيضًا من أن المعاملات تتغير بين استدعاءين ولا تتسرب بيانات حساب إلى طلب آخر. هذا الفصل يسمح بإضافة Cache First لاحقًا حول المصدر دون تكرار كود الشبكة داخل كل شاشة.

مراجع التنفيذ

لإكمال هذا الجزء، انتقل إلى تحويل JSON إلى Model في Flutter مع Null Safety والتحقق من الأنواع، ثم طبّق الربط الذي يناسب بنية مشروعك.

صور الشرح السابق

تهيئة class لاستقبال العمليات من الapi كيفية تخطي الerror الذي يتم الحصول عليه من الapi في بعض الوقت إنشاء class للعنوان النهائي للapi كتابة logic الapi بداخل الRepository التعامل مع الapi بإستخدام الbloc إنشاء حالات داخل ملف state
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع