Junit4: يقدم التسلسل الهرمي BiMatcher

الميزة الجيدة هي تقديم BiMatcher التسلسل الهرمي (تناظري org.hamcrest.Matcher ، لكن يستهلك 2 args). بدلاً من ذلك ، يمكن استخدام Comparator القياسي لهذا الغرض. يمكن أيضًا استخدام BiPredicate (سيؤدي هذا إلى ربط JUnit بجافا 8 ، ولكنه سيضيف منطق AND / OR / NOT خارج الصندوق).
بضع ملاحظات لجميع التعليمات البرمجية الإضافية:

• سيتم استخدام أسماء BiMatcher و BiPredicate و Comparator بالتبادل.
• كل التعليمات البرمجية ليست نهائية وهي مجرد فكرة عامة.

الطرق الرئيسية لإضافة فئة Assert :

• assertThat(T expected, T actual, Comparator<T> biMatcher);
• assertThat(String message, T expected, T actual, Comparator<T> biMatcher); (ربما ليس ضروريًا ، انظر أدناه).
• طرق متعددة assertArray() (انظر أدناه).

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

مثال حقيقي (من خلاله بدأت بالفعل أفكر في هذه الميزة): الحاجة إلى اختبار جميع الكائنات في المصفوفة متشابهة أو غير متشابهة (اعتمادًا على علم منطقي).

مع قدرات JUnit الحالية سيبدو كما يلي:
أقصر:

for (int i = 0; i < elements.length - 1; i++) {
  if (checkSame) { // Same
    assertSame("elements must be the same.", elements[i], elements[i + 1]);
  } else { // Not same
    assertNotSame("elements must be not the same.", elements[i], elements[i + 1]);
  }
}

أداء أفضل (لكن من يهتم بالأداء في الاختبارات):

if (checkSame) { // Same
  for (int i = 0; i < elements.length - 1; i++) {
    assertSame("elements must be the same.", elements[i], elements[i + 1]);
  }
else { // Not same
  for (int i = 0; i < elements.length - 1; i++) {
    assertNotSame("elements must be not the same.", elements[i], elements[i + 1]);
  }
}

يمكننا أيضًا تنفيذ Comparator واستخدام assertTrue()/assertFalse() ، لكن كود إنشاء المقارنات سيكون كبيرًا أيضًا (ما لم نستخدم lambdas).

مع رمز النهج الجديد سيبدو أقصر وأنظف بكثير بالنسبة لي ، مثل هذا:

Comparator<T> comparator = checkSame ? BiMatchers.same() : BiMatchers.notSame();
String message = checkSame ? "elements must be the same." : "elements must be not the same.";
for (int i = 0; i < elements.length - 1; i++) {
  assertThat(message, elements[i], elements[i + 1], comparator);
}

لجعلها أقصر ، يمكننا تمديد Comparator إلى MessagedComparator مع خاصية message اختيارية ، لذلك ستأخذها JUnit من هناك بطريقة ما. مثله:

MessagedComparator<T> comparator = checkSame ? BiMatchers.same("elements must be the same.") : BiMatchers.notSame("elements must be not the same.");
for (int i = 0; i < elements.length - 1; i++) {
  assertThat(message, elements[i], elements[i + 1], comparator);
}

العواقب بعيدة المدى:
1) ستكون فئة Assert مرنة جدًا بشكل عام ، لأنه يمكنك استخدام أي مقارن قياسي أو مقارن خاص بدون الكثير من التعليمات البرمجية.
2) نتيجة لما سبق ، يمكن استخدام لامدا بسهولة أكبر لحقن أي شروط.
3) يمكن إضافة تسلسل منطقي إضافي (AND ، OR ، NOT) خارج الصندوق (شيء مشابه لـ org.hamcrest.CoreMatchers ). مطلوب حاليًا طريقة جديدة لأي ميزة مصغرة جديدة ، على سبيل المثال assertNotSame() بجانب assertSame() إلخ. أو مرة أخرى نحتاج إلى طرق assertTrue()/assertFalse() .
4) يمكن إعادة هيكلة فئة Assert بالكامل إلى نموذج موحد. مجرد مثال واحد:

public static void assertSame(String message, Object expected, Object actual) {
  assertThat(message, expected, actual, BiMatchers.same())
}

public static void assertThat(String message, T expected, T actual, Comparator<T> biMatcher) {
...
}

أو كما سبق ذكره:

public static void assertSame(String message, Object expected, Object actual) {
  assertThat(expected, actual, BiMatchers.same(message))
}

public static void assertThat(T expected, T actual, MessagedComparator<T> biMatcher) {
...
}

5) يمكن إضافة طرق assertArray() (وبالتالي إعادة بناء الطرق القديمة). على سبيل المثال:

public static void assertArrayEquals(boolean[] expecteds, boolean[] actuals) {
  assertArray(expecteds, actuals, BiMatchers.equals());
}

public static void assertArray(boolean[] expecteds, boolean[] actuals, Comparator<Boolean>) {
...
}

لذلك على سبيل المثال ، يمكنك التحقق من أن جميع العناصر في صفيفتين متطابقة بسهولة:

Assert.assertArray(array1, array2, BiMatchers.same());

يمكن أيضًا التحكم في طول المصفوفة أو عمليات التحقق الأخرى بشكل منفصل. كود مزيف:

Assert.assertArray(array1, array2, and(sameLength(), same()));