تأثير تصميم البرنامج

مفردات

English	المعنى
modular/ˈmɒdjʊlə/	وحدوي

يمكن لتصميمين نظيفين تقديم متوسطات مختلفة

يحتوي سجل خيالي على درجات 80، غائبة، و100. اعتبار الغياب بصفر يعطي (80 + 0 + 100) / 3 = 60؛ استبعاد النتيجة الغائبة يعطي (80 + 100) / 2 = 90.
يمكن لطرق منفصلة حساب كل نتيجة بشكل صحيح. لا تختار التنظيم سياسة الإبلاغ: حدد ما يعنيه الغياب، ومن يقرر، وما هو المقام الذي يجب أن يظهره التقرير قبل استخدام النتيجة.

يتطلب نظام الدرجات أكثر من أسماء طرق نظيفة

تعطي السجلات نفسها 60 أو 90 تحت سياستين صريحتين لتسجيل الدرجات المفقودة

تدريب

الدرجات هي 80، غائبة و100. وفقاً لسياسة الدرجات المتاحة، ما هو المتوسط الحسابي؟

Difficulty 2/5 · 140 coins + a small bonus on first completion today

حوّل المتطلبات إلى عقد

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

فصل المسؤوليات عن التحقق

يفصل التصميم النموذجي بين readScores وaverageAvailable وprintReport. يمكن التحقق من طريقة المتوسط باستخدام قيم معروفة دون قراءة ملف أو التقاط مخرجات منسق.
يساعد الفصل عندما تظل الواجهات واضحة. قد يتطلب تغيير معنى الغياب أيضًا تغييرات في الحساب والإبلاغ والتحقق؛ لا تمنع الطرق الصغيرة والأسماء الجيدة وحدها تلك الاعتماديات.

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

بالنسبة لسياسة الدرجات المتاحة، تحقق من [80، غائب، 100] يعطي 90، ودرجة واحدة 80 تعطي 80، بينما [غائب، غائب] ينتج النتيجة المتفق عليها "لا نتيجة". لا تكتفِ بالتحقق من أن البرنامج يعمل فقط.
الحساب أدناه يستخدم null للقيم المفقودة. يُرجع متوسطًا كعدد عشري (double) ويرفض حالة عدم وجود أي قيم. يفترض مصفوفة من الدرجات العادية غير الفارغة؛ حيث تكون التحقق من صحة الإدخال والإبلاغ مسؤوليات منفصلة.

Example

public class AverageAvailable {
    public static double averageAvailable(Integer[] scores) {
        double total = 0;
        int present = 0;
        for (Integer score : scores) {
            if (score != null) {
                total += score;
                present++;
            }
        }
        if (present == 0) {
            throw new IllegalArgumentException("No available scores");
        }
        return total / present;
    }
}

تدريب

التصميم المعياري (قطع مستقلة ذات أسماء جيدة) أسهل بشكل رئيسي في...