الدليل الإرشادي للتحقّق من الاتصال

يعرض هذا المستند طرق استخدام عمليات التحقّق من الاتصال.

أمثلة على القيم

عند تحديد عمليات التحقّق من الاتصال للعناصر الإدخال والإخراج، يجب عادةً النظر إلى عمليات التحقّق على أنّها تمثّل أنواعًا.

يجب أن تتضمّن عمليات التحقّق من الإدخالات كل "نوع" تقبله، ويجب أن تتضمّن عمليات التحقّق من المخرجات بالضبط ما "تُعرِض"ه.

قبول نوع واحد

في أبسط الحالات التي تريد فيها إنشاء كتلة "تستلم" أو "تعرض" نوعًا واحدًا، عليك تضمين هذا النوع في عملية التحقّق من الاتصال.

مجموعة قيم تقبل نوعًا واحدًا

قبول أنواع متعدّدة

لإنشاء قالب "يقبل" أنواعًا متعددة، عليك تضمين كل نوع مقبول في عملية التحقّق من اتصال الإدخال.

مجموعة قيم تقبل أنواعًا متعددة

وفقًا للعرف، إذا كان يمكن قبول ناتج في بعض الأحيان في حالات متعددة (على سبيل المثال، إذا كنت تسمح باستخدام الأرقام أحيانًا كسلسلة)، يجب أن يكون الناتج أكثر تقييدًا، ويجب أن تكون المدخلات أكثر تساهلاً. يضمن هذا العرف عدم ربط النواتج بأماكن غير متوافقة.

قبول أي نوع

لإنشاء وحدة "تقبِّل" أي نوع، عليك ضبط فحص اتصال الإدخال على null.

كتلة قيمة تقبل أي نوع

الأنواع الفرعية للإرجاع

لإنشاء كتلة "تعرِض" نوعًا فرعيًا، عليك تضمين النوع والنوع الفائق في عملية التحقّق من اتصال الإخراج.

كتلة قيمة تعرض نوعها ونوعها الأعلى

في ما يتعلّق بالأنواع الفرعية، لا بأس بإجراء عمليات تحقّق متعدّدة في عملية تحقّق من الإخراج، لأنّ الكتلة تُعرِض دائمًا كلا النوعَين.

عرض أنواع مستندة إلى مَعلمات

لإنشاء كتلة "تعرِض" نوعًا يتضمّن مَعلمات، عليك تضمين كلٍّ من الإصدار الذي يتضمّن مَعلمات والإصدار الذي لا يتضمّن مَعلمات في عملية التحقّق من الاتصال في الإخراج.

استنادًا إلى مدى صرامة اللغة التي تريد حظرها، قد تحتاج أيضًا إلى تضمين متغيرات النوع.

كتلة قيمة تعرض نوعها المُستخدِم للمَعلمات ونوعها غير المستخدِم للمَعلمات

تمامًا كما هو الحال مع الأنواع الفرعية، لا بأس بإجراء عمليات تحقّق متعدّدة في عملية التحقّق من الإخراج، في هذه الحالة، لأنّ الكتلة تُعرِض دائمًا كلا النوعَين.

أمثلة على تسلسل استدعاء الدوال أو العبارات

هناك بعض الطرق الشائعة التي يحدّد بها المطوّرون عمليات التحقّق من الربط السابق والربط التالي. وعادةً ما تُعتبر هذه الشروط بمثابة قيود على ترتيب الكتل.

يجب أن تتضمّن عمليات الربط التالية الكتل التي يجب أن تتبع الكتلة الحالية، ويجب أن تتضمّن عمليات الربط السابقة ما "هي" الكتلة الحالية.

الحفاظ على ترتيب الوحدات الأساسية

لإنشاء مجموعة من الكتل التي ترتبط بترتيب محدّد، عليك تضمين الكتل التي يجب أن تتبع الكتلة الحالية في عملية التحقّق من الربط التالية، و "نوع" الكتلة الحالية في عملية التحقّق من الربط السابقة.

مجموعات الجمل التي لها ترتيب إجباري

السماح بالكثير من الكتل الوسطى

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

مجموعات عبارات تسمح بالعديد من المجموعات الوسطى

عدم السماح بعرض أيّ إعلانات في منتصف الصفحة

لإنشاء مجموعة من الكتل المرتبة التي تكون فيها الكتل الوسطى اختيارية، عليك تضمين إدخال واحد على الأقل من كلّ من عملية التحقّق السابقة من الاتصال في الكتلة الوسطى وعملية التحقّق السابقة من الاتصال في الكتلة الأخيرة في عملية التحقّق التالية من الاتصال في الكتلة الأولى. يتيح ذلك أن يتبع القسم الأول إما قسم وسطي أو قسم آخر.

مجموعات عبارات لا تسمح بإضافة مجموعات وسط

الحِزم التي تتضمّن خيارَين

لإنشاء مجموعة يمكن أن تليها فقط مجموعات من مجموعة واحدة أو مجموعات من مجموعة أخرى (وليس كليهما)، عليك إجراء أمرَين:

  1. يجب تضمين إدخال واحد على الأقل من كلتا مجموعتَي عمليات التحقّق السابقة من الاتصال في عملية التحقّق التالية من الاتصال في المجموعة الأولى.

  2. عليك تحديد عمليات التحقّق التالية من الربط للمجموعات بحيث تتضمّن فقط القيم التي تم تضمينها في عمليات التحقّق السابقة من الربط (كي لا يمكن متابعتها إلا بواسطة مجموعات من المجموعة نفسها).

مجموعات العبارات التي يمكن أن يتبعها عدة أنواع من المجموعات أو
عدة أنواع أخرى، ولكن ليس كلاهما