جلب الأخبار باستخدام Dio في Flutter يحتاج عنوان خدمة صحيحًا وعقد JSON واضحًا ومهلات زمنية. أمثلة الأخبار التي تنشر مفتاح مزوّد الخدمة داخل التطبيق لا تحميه؛ يمكن استخراج مفاتيح العميل من الحزمة حتى لو لم تظهر في الواجهة. المثال المراجع يستخدم نقطة /news في خادم وسيط تملكه، ويحافظ الخادم على أسرار المزوّد.
تجهيز Dio والنموذج
أضف dio 5.11.1. أنشئ العميل عبر createApiClient بعنوان API الخاص بك ثم NewsRepository. هذا مثال على شكل التكامل وليس عنوانًا لخدمة جاهزة؛ يجب أن تعيد /news غلاف articles كما يوضح parseArticles. راجع شروط المزوّد والمنصات المدعومة قبل نشر تطبيق يعتمد عليه.
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),
));
قراءة الاستجابة دون فهارس ثابتة
بعد await repository.search اعرض طول القائمة وعناصرها بأمان. لا تستخدم articles[5] أو articles[3] للتأكد من وصول البيانات؛ قد تكون القائمة أقصر أو فارغة. إذا كنت تتعامل مباشرة مع مزوّد يطلب category أو country فتأكد من أسماء القيم المقبولة في توثيقه، ولا تفترض أن كل كلمة مفردة تمثل تصنيفًا صالحًا.
مهلات الاتصال والأخطاء
connectTimeout وreceiveTimeout تستقبلان Duration في Dio 5. افصل انقطاع الشبكة عن HTTP المرفوض وعن بنية JSON غير المتوقعة. لا تجعل receiveDataWhenStatusError يعني أن الطلب نجح؛ وجود جسم استجابة عند الخطأ مفيد للتشخيص لكنه لا يغير معنى حالة HTTP.
حماية المفاتيح وتنظيم التحديث
لا تسجل عنوانًا يتضمن مفتاحًا أو رأس Authorization كاملًا. استبدلت القيم المنشورة سابقًا بهذا التكامل التوضيحي؛ إذا كان مفتاح قد نُشر فعليًا وصالحًا، فإزالته من المقال لا تلغي النسخ السابقة منه ويلزم تدويره لدى المزوّد. استعمل حدود معدل وذاكرة مؤقتة في الخادم بحسب سياسة الخدمة.
اختبر نجاحًا ونتيجة فارغة ورفضًا ومهلة زمنية. شغّل الطلب من initState أو طبقة الحالة، لا مع كل build. ثم انتقل لدرس عرض القائمة لتوفير بديل للصور المفقودة، ولدرس البحث لإلغاء الطلب السابق عند تغير الكلمة بسرعة.
مراجع التنفيذ
لإكمال هذا الجزء، انتقل إلى تحويل JSON إلى Model في Flutter مع Null Safety والتحقق من الأنواع، ثم طبّق الربط الذي يناسب بنية مشروعك.






