شارك المقالة
فلترة Firestore في Flutter بأكثر من شرط والفهارس المركبة

فلترة Firestore في Flutter بأكثر من شرط والفهارس المركبة

فلترة Firestore في Flutter باستخدام where وarrayContains مع أكثر من شرط، ومعالجة الفهرس المركب والنتائج الفارغة وحدود الاستعلام.

فلترة Firestore في Flutter باستخدام where وarrayContains مع أكثر من شرط، ومعالجة الفهرس المركب والنتائج الفارغة وحدود الاستعلام.

ابدأ بعقد واضح للحقول

يمكن تقييد قائمة المنتجات بقسم معين ولون داخل مصفوفة colors. حقل category يجب أن يكون نصًا متسقًا، وcolors مصفوفة وليست سلسلة واحدة مفصولة بفواصل. استعلام صحيح على بيانات مختلفة النوع قد يعيد قائمة فارغة دون أن يكون اتصال Firebase معطلًا. جهز عدة مستندات اختبار مع حالات تطابق واختلاف، ثم افحصها داخل Console قبل ربط النتائج بتصميم معقد.

تركيب الشروط على الخادم

يربط المثال where للمساواة وwhere مع arrayContains ثم limit لتقييد النتائج. هذا يوفر نقل بيانات غير مطابقة إلى الهاتف وتصفيتها محليًا. لا يعني توفر أكثر من where أن كل تركيب ممكن؛ توجد حدود لمعاملات المصفوفات وOR والاستعلامات المركبة. راجع توثيق التركيب الذي تستخدمه عند إضافة شرط جديد، ولا تفترض أن شرطين نجحا منفصلين سيعملان معًا تلقائيًا.

إنشاء الفهرس المطلوب

إذا أعاد Firestore خطأ يتطلب فهرسًا، راجع رابط إنشاء الفهرس الذي يظهر في بيئة التطوير وتأكد من المشروع والحقول واتجاه الترتيب. انتظر اكتمال البناء قبل إعادة الاختبار. لا تحول الخطأ إلى نتيجة فارغة فتبدو للمستخدم كأن المنتجات غير موجودة. احفظ تعريفات الفهارس في مشروعك عند إدارتها عبر CLI حتى يمكن تكرار الإعداد في بيئة الاختبار والإنتاج.

الفلاتر ليست قواعد أمان

استعلام يعرض قسمًا واحدًا لا يمنع عميلًا آخر من محاولة طلب أقسام أخرى. اضبط قواعد Firestore للوصول المسموح، وتذكر أن القواعد لا تصفي النتائج نيابة عنك؛ يجب أن يكون الاستعلام كله مسموحًا. عند تغيير اللون أو القسم أعد ضبط مؤشر pagination وألغ أثر الاستجابة القديمة. اعرض حالات تحميل وخطأ ونتيجة فارغة كلًا على حدة، ولا تجعل القائمة الفارغة تدور في علامة تحميل بلا نهاية.

المثال التطبيقي وحدوده

أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.

import 'package:cloud_firestore/cloud_firestore.dart';

Future<QuerySnapshot<Map<String, dynamic>>> filterProducts(
  String category, String color,
) {
  return FirebaseFirestore.instance.collection('products')
      .where('category', isEqualTo: category)
      .where('colors', arrayContains: color)
      .limit(20)
      .get();
}

الصور والفيديو من الشرح

المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.

How can you use where property twice in the same code Flutterhow to Indexes between two field in firebase

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

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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