العودة إلى كل المقالات
برمجة وتطوير آخر تحديث: 2 نوفمبر 2026

الصورة تختفي بين صفحتين: ابن مؤشراً مركباً لمعرض SQLite

ثلاث صوانٍ مرتبة لأوراق صور أوانٍ خزفية مع فواصل ملونة وورقة مسحوبة جزئياً على طاولة أرشيف
ثلاث صوانٍ مرتبة لأوراق صور أوانٍ خزفية مع فواصل ملونة وورقة مسحوبة جزئياً على طاولة أرشيف.

يقوم جدول الوسائط المحلي assets على بنية تضم ثلاثة أعمدة رئيسية هي id وcreated وkind، حيث يمثل id المفتاح الأساسي للجدول بينما يمثل created عدداً صحيحاً اصطناعياً يُستخدم لأغراض الترتيب فقط وليس طابعاً زمنياً حقيقياً أو حقلاً مقيساً بالثواني والمللي ثوان. تظهر المشكلة الهيكلية مباشرة في أول صفين أُدرجا داخل قاعدة البيانات التجريبية؛ فالصف الأول يحمل المعرف الرقمي 1 مع قيمة ترتيب اصطناعية تبلغ 100 ونوع أصل هو image، في حين يحمل الصف الثاني المعرف الرقمي 2 مع قيمة الترتيب الاصطناعية ذاتها 100 والنوع image نفسه. عندما تحاول وظيفة التصفح الاعتماد حصرياً على العمود created للفصل بين الصفحات والانتقال من عنصر إلى آخر، فإنها تفترض ضمنياً أن كل قيمة في هذا العمود تقابل سجلاً فريداً داخل قاعدة البيانات. هذا الافتراض ينهار في الواقع العملي بمجرد تكرار القيمة 100 بين صفين مستقلين، مما ينتج عنه سلوك خاطئ يؤدي إلى تجاوز السجل الثاني كلياً بمجرد مغادرة السجل الأول ذي القيمة المطابقة.

ابدأ بالسجل الثاني الذي أسقطه الوقت وحده

في الاختبار المسجل test_timestamp_only_skips_tie، تستدعي البيئة المحلية الدالة المعيبة broken_page بتمرير قيمة المفتاح الاصطناعي 100 في المعامل after_created مع حد جلب افتراضي مقداره صف واحد. ينفذ الاستعلام العبارة الشرطية SELECT id, created FROM assets WHERE kind=? AND created>? ORDER BY created LIMIT ? معوضاً عن kind بالقيمة image وعن الشرط بالمعادلة الحسابية created > 100. وبما أن السجل الثاني في الجدول يمتلك القيمة 100 تماماً في عمود created، فإن الشرط المنطقي 100 > 100 ينتج القيمة المنطقية false. ونتيجة لذلك، يستبعد محرك SQLite الصف الثاني (2, 100) استبعاداً تاماً وفورياً، ويقفز مباشرة إلى أول صف يحقق عدم المساواة الصارمة، وهو الصف رقم 3 الذي يمتلك القيمة 101. تؤكد نتيجة الاختبار المحلي هذا التجاوز بشكل قاطع، حيث تعيد الدالة القائمة [(3, 101)] بدلاً من إعادة الصف الثاني الذي يشترك في علامة الترتيب مع الصف الأول.

ينشأ هذا السلوك لأن الفرز وفق عمود created وحده ينتج ترتيباً جزئياً ضعيفاً لا يحدد أسبقية مطلقة بين الصفوف التي تحمل القيمة الترتيبية ذاتها داخل الجدول assets. فعندما تتكافأ السجلات في قيمة مفتاح الفرز، تصبح العلاقة الترتيبية بينها غير معرفة رياضياً ما لم يُضف عمود تمييزي قاطع. ويزداد الخلل حدة عندما يتحول هذا العمود غير الفريد إلى شرط حصر صارم في عبارة WHERE بواسطة معامل المقارنة created > ?، لأن هذا المعامل يقتطع كل فئة التكافؤ الترتيبية التي ينتمي إليها السجل السابق بمجرد الانتهاء من أول عنصر فيها. لا يدرك الاستعلام أن هناك عناصر أخرى تمتلك نفس القيمة الزمنية الاصطناعية لكنها تقع تالياً في التسلسل الداخلي أو الترتيب الطبيعي، فيعامل الوصول إلى القيمة 100 كإشارة اكتمال لكافة الصفوف التي تحمل الرقم 100، مما يقصي السجل 2 ويجعله مفقوداً تماماً في مسار التصفح المعتمد على المفتاح الأحادي.

جرت صياغة هذه الظاهرة وفحصها ضمن إطار معزول تماماً يضم تسعة اختبارات وحدة محلية تعمل على اتصال SQLite وحيد داخل الذاكرة بالإصدار 3.45.1 مع لغة بايثون 3.12.3. تمثل هذه البيئة الحدود التجريبية الكاملة لكافة الاختبارات المنفذة في هذا العمل، حيث لا تشمل أي استدعاءات شبكية أو قياسات لأداء المحرك أو عمليات استرجاع متزامنة من خيوط معالجة متعددة. إن إسقاط السجل 2 في هذا السياق المحدد بدقة ليس دليلاً على عطل في نظام الملفات أو خلل في مكتبة sqlite3 البرمجية، بل هو تطبيق حسابي سليم لاستعلام منطقي معيب اعتمد على افتراضات فرز غير مكتملة، وهو ما يفرض إدخال المفتاح الأساسي للجدول كعنصر حاسم لكسر التعادل وبناء معيار فرز تام لا يقبل الإسقاط.

شغّل الاستعلامين على بيانات المعرض الأصلية

تعتمد بيانات المعرض الثابتة في ملف الاختبارات على سبعة صفوف محددة تم إدخالها داخل جدول assets عبر استدعاء executemany بمدخلات صريحة. تضم هذه الصفوف ستة عناصر من نوع image وعنصراً واحداً من نوع video، مع توزيع مقصود لقيم الترتيب الاصطناعية لإبراز حالات التعادل: الصف (1, 100, image)، والصف (2, 100, image)، والصف (3, 101, image)، والصف (4, 101, video)، والصف (5, 102, image)، والصف (6, 102, image)، وأخيراً الصف (7, 103, image). جرى تشغيل كل من الاستعلام الأحادي والاستعلام المركب على هذه المجموعة الثابتة للتحقق من كيفية معالجة كل استعلام لتكرار القيمة 100 وتكرار القيمة 102 عند طلب صفوف لاحقة.

تقارن SQLite القيم الصفية من اليسار إلى اليمين، ويمكن استعمال زوج أعمدة لتحديد الحد التالي في نافذة تمرير. SQLite row values and scrolling windows

تستخدم الدالة المعيبة broken_page استعلاماً ثابتاً يعزل التصفية والفرز في حدود قيمة أحادية عبر النص البرمجي: SELECT id, created FROM assets WHERE kind=? AND created>? ORDER BY created LIMIT ?. عند تنفيذ broken_page(self.db, 100, limit=1)، يربط المحرك المتغيرات بالقيم المقابلة، فيبحث عن صفوف تنتمي للنوع image وتكون قيمة created فيها أعلى قطيعاً من 100. هنا يسقط السجل (2, 100) رياضياً لأن المقارنة الثنائية 100 > 100 تعيد قيمة خاطئة، فيسترجع الاستعلام السجل (3, 101) مباشرة، محققاً تجاوزاً للصف الثاني في أول خطوة تصفح تلي قراءة الصف الأول.

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

في المقابل، تستخدم الدالة المطورة page استعلام مقارنة القيم الصفية row value comparison عبر التعبير: SELECT id, created FROM assets WHERE kind=? AND (created, id) > (?, ?) ORDER BY created, id LIMIT ?. وعند تشغيل الاختبار test_tie_retained باستدعاء page(self.db, cursor=(100, 1), limit=1)، يمرر المعامل cursor الزوج العددي (100, 1) إلى نص الاستعلام. تقوم SQLite بمقارنة المتجهات الصفية من اليسار إلى اليمين وفق المعيار المكافئ رياضياً للتعبير (created > 100) OR (created = 100 AND id > 1). ونظراً لأن السجل الثاني يمتلك created = 100 والمعرف id = 2، فإن الشق الثاني من المقارنة يتحقق بنجاح لأن 2 أكبر من 1، فتعيد الدالة القائمة [(2, 100)] بنجاح ودون أي قفز فوق السجلات المتعادلة.

يجب الانتباه بدقة إلى الفرق الجوهري بين ترتيب الأعمدة في عبارة الفرز والمؤشر وبين ترتيب الأعمدة المسترجعة في جملة SELECT. تعيد الدالتان الأعمدة بالترتيب SELECT id, created، مما يجعل الصف المرتجع عبارة عن زوج من نمط (id, created) مثل (2, 100). بينما يتطلب المؤشر وشرط المقارنة الصفية والفرز في ORDER BY أن يكون الترتيب هو (created, id) حصراً؛ لأن created هو معيار الفرز الأساسي وid هو المعيار الثانوي لكسر التعادل. هذا التمايز يفرض على أي شيفرة تستخدم الدالة page استخراج قيم الصف المرتجع وإعادة ترتيبها بعكس موقعها لتشكيل المؤشر اللاحق، بحيث تصبح القيمة الثانية r[1] هي العنصر الأول في المؤشر والقيمة الأولى r[0] هي العنصر الثاني.

إن مطابقة جملة المقارنة الصفية (created, id) > (?, ?) مع جملة الترتيب ORDER BY created, id هي الركيزة الحسابية التي تحول مسار التصفح إلى دالة حتمية واضحة المعالم. إذا اختلفت بنية المقارنة عن بنية الفرز، كأن تُعكس الأعمدة في إحداهما دون الأخرى، فإن SQLite ستطبق التصفية وفق اتجاه متعارض مع تسلسل استعراض الصفوف، مما يتسبب في إعادة جلب صفوف سابقة أو إسقاط مجموعات كاملة من النتائج. يوضح تنفيذ الاستعلامين على البيانات السبعة الأصلية أن التصفية الثنائية تزيل تماماً أي اعتمادية على ترتيب الإدراج الداخلي أو ترقيم المعرفات المنفرد، وتجعل كل صف مستقلاً بحدوده الموقعية الثنائية داخل فضاء العرض المحدد.

catalog_pages.py

def broken_page(db, after_created, limit=1):
    return db.execute('SELECT id,created FROM assets WHERE kind=? AND created>? ORDER BY created LIMIT ?',
                      ('image', after_created, limit)).fetchall()

def page(db, kind='image', cursor=None, limit=2):
    if not isinstance(kind, str) or not kind or type(limit) is not int or not 1 <= limit <= 100:
        raise ValueError('Invalid local query options')
    if cursor is not None and (not isinstance(cursor, tuple) or len(cursor) != 2
                              or any(type(value) is not int for value in cursor) or cursor[1] <= 0):
        raise ValueError('Expected a (created,positive id) cursor')
    if cursor is None:
        return db.execute('SELECT id,created FROM assets WHERE kind=? ORDER BY created,id LIMIT ?',
                          (kind, limit)).fetchall()
    return db.execute('SELECT id,created FROM assets WHERE kind=? AND (created,id)>(?,?) ORDER BY created,id LIMIT ?',
                      (kind, *cursor, limit)).fetchall()

نطاق التحقق المحلي: تسعة اختبارات على SQLite داخل الذاكرة، باستخدام سجلات اصطناعية. شملت الاحتفاظ بالوقت المتساوي، والتصفح الكامل، ومرشح النوع، والنتيجة الفارغة، ورفض حد منطقي ومؤشر غير صالح، وإضافة خلف المؤشر وحذف صف سابق. ليست تجربة تزامن أو لقطة ثابتة أو أداء، ولم يُنفذ ترميز مؤشر مربوط بالمرشح أو توقيعه. البيئة: Python 3.12.3 وSQLite 3.45.1 على Windows.

اجعل حد الصفحة وترتيب المؤشر عقداً واحداً

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

تتعامل الدالة مع معامل الحد limit بحذر استثنائي في بيئة بايثون لتفادي التداخل النوعي الشهير بين الأعداد الصحيحة والقيم المنطقية؛ حيث يرث النوع bool من النوع int في بايثون، مما يجعل الفحص التقليدي عبر دالة isinstance(limit, int) يعيد القيمة True للمتغير المنطقي True. لمعالجة هذا الخلل الدلالي، تستخدم الدالة الفحص المباشر الصارم type(limit) is not int متبوعاً بفحص المجال 1 <= limit <= 100. يختبر الاختبار المحلي test_boolean_limit هذه الحالة تحديداً باستدعاء page(self.db, limit=True)، فيتحقق من أن الدالة تثير فوراً استثناء صريحاً من نوع ValueError يحمل الرسالة النصية 'Invalid local query options'، رافضة تمرير القيمة المنطقية كعدد صحيح لحجم الصفحة.

يخضع المعامل cursor لرقابة نوعية مكافئة تضمن كونه إما None للدفعة الأولى أو زوجاً عددياً صريحاً يطابق حقول المقارنة. تشترط الدالة أن يكون المؤشر من نوع tuple بطول 2 حصراً، وأن تكون جميع عناصره أعداداً صحيحة عبر التعبير any(type(value) is not int for value in cursor)، بالإضافة إلى اشتراط كون المعرف موجباً عبر الشرط cursor[1] <= 0 الذي يثير خطأ إذا لم يكن المعرف أكبر من الصفر. يفحص الاختبار المحلي test_bad_cursor هذه الضوابط بتمرير زوج يحتوي على سلسلة نصية cursor=(100, '1')؛ حيث يؤدي هذا الاستدعاء مباشرة إلى إثارة استثناء ValueError برسالة نصية واضحة: 'Expected a (created,positive id) cursor'، مما يمنع تمرير بيانات نصية أو مشوهة إلى عبارة الاستعلام.

يوفر هذا العقد التزاماً مزدوجاً يضمن صحة الاستعلام عند كل مسار استدعاء؛ فإذا كان cursor هو None، تتجاوز الدالة شرط التصفية الموقعي وتنفذ استعلام البداية البسيط: SELECT id, created FROM assets WHERE kind=? ORDER BY created, id LIMIT ? مستخدمة نوع الأصل وحد الجلب فقط. أما إذا كان المؤشر موجوداً واستوفى شروط الفحص، يتم تفكيكه برمجياً داخل جملة التنفيذ عبر الصيغة (kind, *cursor, limit)، مما يضمن حقن قيمتي created وid بالترتيب السليم في مقابلة التعبير (created, id) > (?, ?). يحمي هذا التصميم الصارم استقرار محرك قاعدة البيانات ويحول دون تنفيذ استعلامات مشوهة قد تنتج نتائج جزئية يصعب تفسيرها.

تابع السجلات الستة عبر الصفحات

يختبر الاختبار المسجل test_static_full_traversal مسار التصفح الكامل على السجلات السبعة المخزنة في الذاكرة باستخدام حجم دفعة ثابت مقداره صفان limit=2 وحلقة تكرار تعتمد على فحص القائمة المرتجعة r عبر التعبير while rows := page(self.db, cursor=cursor, limit=2). نظراً لأن جدول assets يحتوي على ستة صفوف من نوع image وصف واحد فقط من نوع video، فإن الهدف التشغيلي للاختبار هو استرجاع المعرفات الستة الخاصة بالصور فقط وفق ترتيبها الحسابي الدقيق: [1, 2, 3, 5, 6, 7]، مع تجاوز السجل رقم 4 تلقائياً لاختلاف نوعه، والتحقق من أن المعرض يُستعرض على دفعات متتالية دون انقطاع أو تكرار.

تبدأ الدفعة الأولى باستدعاء الدالة مع cursor=None، فينفذ محرك SQLite استعلام البداية المفرز تصاعدياً بحد جلب 2: SELECT id, created FROM assets WHERE kind='image' ORDER BY created, id LIMIT 2. يعيد هذا الاستدعاء السجلين الأولين في الجدول وهما [(1, 100), (2, 100)]. تلتقط حلقة الاختبار هذين السجلين وتضيف المعرفين 1 و2 إلى قائمة seen التراكمية. بعد ذلك، تشتق الشيفرة المؤشر الجديد من السجل الأخير في الدفعة وهو (2, 100)؛ ونظراً لأن أعمدة SELECT تعيد (id, created) بينما يتطلب المؤشر (created, id)، يُبنى المؤشر الجديد بالصيغة cursor = (rows[-1][1], rows[-1][0]) ليصبح الزوج العددي الصريح (100, 2).

تنطلق الدفعة الثانية باستدعاء page(self.db, cursor=(100, 2), limit=2)، فيطبق المحرك شرط المقارنة الصفية (created, id) > (100, 2) بالتزامن مع تصفية kind='image'. يستبعد هذا الشرط السجلين 1 و2 لوقوعهما عند المؤشر أو قبله، ويفحص السجل 3 ذو القيم (101, 3) فيجده محققاً للشرط، ثم يتجاوز السجل 4 ذو القيم (101, 4) لكونه من نوع video، وينتقل إلى السجل 5 ذو القيم (102, 5) فيدرجه ضمن النتائج. تعيد هذه الدورة القائمة [(3, 101), (5, 102)]. تسجل حلقة الاختبار المعرفين 3 و5 داخل seen، ثم تستخرج المؤشر اللاحق من السجل 5 ليكون الزوج العددي (102, 5).

تستدعي الدورة الثالثة الدالة بالمؤشر (102, 5) وحد جلب 2، فتطلب SQLite الصفوف التي تحقق (created, id) > (102, 5) مع kind='image'. يقع السجل 6 ذو القيم (102, 6) تالياً مباشرة لأن له قيمة created مطابقة للمؤشر 102 لكن معرفه 6 أكبر من 5، يليه السجل 7 ذو القيم (103, 7). تعيد الدفعة القائمة [(6, 102), (7, 103)]، وتضاف المعرفات 6 و7 إلى seen، ويصبح المؤشر الجديد (103, 7). في الدورة الرابعة، يُستدعى الاستعلام بالزوج (103, 7)، وبما أنه لا توجد أي صفوف متبقية تحقق الشرط في جدول الصور، يعيد الاستعلام قائمة فارغة []، مما يكسر حلقة while. يتحقق الاختبار بعد ذلك عبر الجملة التأكيدية self.assertEqual(seen, [1, 2, 3, 5, 6, 7]) من استرجاع كافة الصور الست بالتسلسل الصحيح.

افصل مرشح النوع عن هوية الموضع

يقوم التصميم المنطقي للاستعلام على الفصل التام بين معيار تصفية المحتوى المحدد بالعمود kind، وبين معايير تحديد موضع النافذة المعتمدة على الزوج العددي (created, id). يعمل المعامل kind كمرشح تصنيف أفقي يقتطع نطاق البحث ويقصره على فئة محددة من السجلات دون التدخل في ترتيبها الداخلي. أما معيار الموضع فيمثل إحداثيات ثنائية الأبعاد تتحكم في نقطة استئناف القراءة داخل هذا النطاق المقتطع. هذا الفصل يمنع حدوث تشويه في بيانات التصفح ويجعل سلوك النافذة مستقلاً استقلالاً تاماً عن نوع المادة المعروضة سواء كانت صوراً أو مقاطع مرئية.

يختبر الاختبار المحلي test_filter هذا العزل الدلالي عند استدعاء page(self.db, kind='video')؛ حيث يؤدي تغيير نوع الأصل إلى استرجاع السجل الفردي [(4, 101)] الخاص بالفيديو دون أن يتأثر بنظام التصفح المكتوب للصور. كما يؤكد الاختبار test_empty_filter_result السلوك المنضبط للاستعلام عند طلب تصنيف غير موجود في البيانات الأصلية، مثل استدعاء page(self.db, kind='audio')؛ حيث يعيد الاستعلام مباشرة قائمة فارغة [] دون إثارة أخطاء، لأن شرط التطابق kind = 'audio' يعيد false لجميع الصفوف، مما يوضح أن مرشح النوع يعمل كبوابة أولى تلغي الحاجة لمعالجة أي شروط موضعية إذا لم تتطابق الفئة.

يشترط استمرار التصفح الصحيح عبر الصفحات احتفاظ المستدعي بمرشح kind ثابتاً ومطابقاً عبر جميع الاستدعاءات المتتالية؛ لأن المؤشر المستخرج يحمل فقط الإحداثية الحسابية (created, id) دون تضمين اسم التصنيف أو نوع الأصل داخله. إذا بدأ المستدعي التصفح بتصفية kind='image' ثم مرر المؤشر الناتج إلى استعلام يستخدم kind='video'، فإن التصفية ستستأنف من نفس الإحداثية العددية ولكن داخل جدول الفيديوهات، مما قد يسبب قفزاً فوق سجلات فيديو ذات قيم ترتيبية سابقة. لذلك فإن مسؤولية تثبيت المرشحات تقع على عاتق الشيفرة المستدعية التي يجب أن تعامل المؤشر كعلامة موضعية تابعة لمرشح نوع ثابت لا يتغير في منتصف جلسة التصفح.

اختبر الإضافة خلف المؤشر وحذف سجل سابق

تكشف التعديلات التي تطرأ على البيانات أثناء التصفح عن طبيعة حركة النافذة الموجهة للأمام، حيث يختبر الاختبار test_insert_behind_cursor_not_seen إدراج صف جديد في موقع يقع خلف المؤشر الحالي. في هذا الاختبار، تُنفذ الجملة db.execute('INSERT INTO assets VALUES(8, 99, ?)', ('image',)) لإضافة سجل يحمل المعرف 8 والترتيب الاصطناعي 99، بينما يقف المؤشر عند الإحداثية (100, 2) بطلب جلب واسع limit=100. يُرجع الاستدعاء صفوفاً تبدأ من السجل 3 ولا تتضمن السجل المُضاف حديثاً (8, 99)، وتؤكد جملة التأكيد self.assertNotIn((8, 99), …) غياب هذا السجل تماماً عن النتائج المسترجعة.

إن عدم رؤية السجل المُضاف خلف المؤشر ليس ميزة حصرية ولا عيباً تشغيلياً، بل هو نتيجة حسابية مباشرة لطبيعة التصفح الأمامي المعتمد على عدم المساواة الصارمة (created, id) > (100, 2). يطلب الاستعلام صراحة أي صفوف تقع إحداثياتها الترتيبية بعد النقطة المحددة، وبما أن القيمة 99 أصغر من 100، فإن السجل الجديد يقع خارج نطاق البحث المنطقي للنافذة الحالية والمستقبلية. هذا السلوك يمنع اضطراب استعراض الصفحات الحالية وتكرار العناصر التي تم تجاوزها، لكنه يعني في المقابل أن السجلات التي تُدرج بقيم ترتيبية متأخرة لن تظهر للمستخدم ما لم يُعد التصفح من البداية عبر مؤشر فارغ cursor=None.

في سيناريو الحذف، يفحص الاختبار المحلي test_delete_prior_row قدرة الاستعلام على الصمود عند مسح صف يسبق موضع القراءة الحالي. يقوم الاختبار بحذف السجل الأول ذي المعرف 1 عبر الأمر db.execute('DELETE FROM assets WHERE id=1')، ثم يستدعي دالة التصفح مستخدماً مؤشر ذلك السجل المحذوف: page(self.db, cursor=(100, 1), limit=1). تعيد قاعدة البيانات الصف التالي مباشرة وهو [(2, 100)]، متحققة بنجاح عبر self.assertEqual. يبرهن هذا الاختبار على أن المؤشر المركب لا يعتمد على بقاء الصف السابق موجوداً في الذاكرة أو القرص، بل يعامل القيمتين (100, 1) كنقطة مرجعية رياضية مجردة، مما يسمح بمواصلة التصفح حتى لو تعرضت السجلات السابقة للحذف التام.

صمم تمثيل المؤشر لواجهة مقترحة

في واجهات برمجة التطبيقات المقترحة لمعارض الصور، يمكن تمثيل المؤشر المركب كنص معزول opaque token بدلاً من كشف تركيبته العددية الخام للعميل. وبما أن هذه الواجهة مقترحة ولم تُنفذ عملياً ضمن الاختبارات المحلية التسعة، فإن عقدها البرمجي يتطلب تحديد مواصفات الربط بدقة؛ حيث يقوم الخادم بتحويل الزوج العددي المرتجع من آخر صف في الدفعة (created, id) إلى صيغة نصية محددة مثل '100_2' أو سلسلة مشفرة بترميز Base64 الآمن لعناوين الويب، ثم يرسلها داخل حقل استجابة يُسمى مثلاً next_cursor يرافقه مؤشر منطقي يوضح ما إذا كانت هناك صفحات لاحقة.

عندما يطلب العميل الدفعة التالية، يرسل السلسلة النصية ذاتها في معامل الاستعلام دون محاولة تعديلها أو تفسير محتواها داخلياً. تقع مسؤولية التحقق على عاتق الخادم عند استلام الطلب؛ حيث يجب على الشيفرة الخلفية فك تشفير السلسلة، والتحقق من احتوائها على قيمتين عدديتين صحيحتين، والتأكد من أن المعرف موجب، قبل تحويلهما إلى الزوج tuple(created, id) وتمريره إلى الدالة page. إذا فشل فك التشفير أو كانت الصيغة غير مطابقة للمعايير، ترفض الواجهة الطلب فوراً وتُرجع رمز الخطأ HTTP 400، مانعة وصول مدخلات تالفة أو محاولات حقن برمجية إلى محرك الاستعلام المحلي.

يتطلب العقد المقترح أيضاً إلزام العميل بإعادة إرسال نفس معايير التصفية، مثل kind=image، المصاحبة للمؤشر الأصلي لضمان اتساق النتائج. وبما أن المؤشر يمثل موقعاً حسابياً مجرداً داخل فضاء الفرز الكلي ولا يختزن نوع الأصل المستعرض، فإن تغيير المرشح مع استخدام نفس المؤشر سيؤدي إلى تطبيق الإحداثية الموقعية على تصنيف مختلف، وهو ما قد ينتج عنه فقدان عناصر أو جلب بيانات غير متوقعة. يوصى في هذا التصميم المقترح بربط المؤشر بحالة التصفية إما عبر دمجهما في رمز موقع رقمياً أو بالتحقق الصارم من تطابق معاملات الطلب في طبقة الواجهة البرمجية قبل تشغيل الاستعلام.

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

حدد ما تحتاجه إذا كان المعرض يتغير أثناء التصفح

تعتمد دالة التصفح المحلية page على مبدأ التصفح الثابت للأمام عبر مجموعة سجلات موجودة مسبقاً، ولا توفر لقطة متسقة ثابتة snapshot لعالم البيانات إذا كانت قاعدة البيانات تخضع لتعديلات متزامنة. إذا كانت البيئة التشغيلية تسمح بإجراء تعديلات متزامنة من اتصالات متعددة، فإن المعرض المعروض للعميل لن يعكس حالة متجمدة من لحظة فتح الصفحة الأولى، بل سيتأثر بكل تعديل يطرأ على الصفوف التي لم تصل إليها النافذة بعد. إن فهم هذا القيد يمنع المطورين من بناء افتراضات خاطئة حول اتساق البيانات المعروضة في بيئات الإنتاج الديناميكية التي تتطلب آليات عزل إضافية.

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

للتعامل مع التطبيقات التي تشهد تعديلات متزامنة واسعة وتتطلب تزعيماً دقيقاً للمحتوى، يحتاج المطورون إلى تقنيات متقدمة تقع خارج نطاق الاختبارات المحلية الحالية لاتصال الذاكرة الأحادي. تشمل هذه التقنيات اعتماد آليات التتبع الزمني للإصدارات عبر إضافة عمود زمني لتحديث السجلات updated_at، أو تفعيل مستويات عزل المعاملات مثل وضع سجل المعاملات المسبق WAL مع معاملات القراءة طويلة الأمد في SQLite إذا كان حجم المعرض يسمح بذلك. كما يمكن للواجهة الأمامية استخدام قنوات الإشعار اللحظي لتنبيه المتصفح بوجود أصول جديدة تتطلب إعادة ضبط المؤشر وبدء الاستعراض من نقطة الصفر.

يظل مؤشر التصفح المركب المبني على المقارنة الصفية (created, id) > (?, ?) الحل الحسابي الأكثر كفاءة وانضباطاً لاستعراض معارض SQLite محلياً وضمان عدم إسقاط السجلات ذات المفاتيح المكررة. لقد أثبتت الاختبارات التسعة الموثقة في ملف test_example.py أن الاعتماد على ترتيب كلي يجمع بين معيار الفرز والمفتاح الأساسي يزيل كلياً أخطاء التجاوز العشوائي، ويوفر قاعدة تشغيلية صلبة لبيانات المعرض. إن الالتزام بهذا العقد الرياضي الموحد، مع إدراك الآثار المباشرة للتعديلات الموقعية، يمنح الأنظمة البرمجية قدرة فائقة على تقديم تجربة تصفح متسقة وخالية من البيانات المفقودة بين الصفحات.

أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعات آلية. شُغلت الشيفرة الأصلية محلياً ضمن نطاق الاختبارات المسجل، دون ادعاء تجربة بشرية ميدانية أو اتصال بمزود صور أو تجربة توليد فيديو.

التعليقات

كن أول من يعلّق على هذا المقال.

أضف تعليقاً

بريدك لن يُنشر. الحقول المطلوبة معلَّمة بنجمة.