断言可迭代的每个元素与给定匹配器匹配的惯用 Hamcrest 模式是什么？

Question

检查以下代码片段：

    assertThat(
        Arrays.asList("1x", "2x", "3x", "4z"),
        not(hasItem(not(endsWith("x"))))
    );

这断言列表中不存在不以“x”结尾的元素。当然，这是表示列表中所有元素都以“x”结尾的双重否定方式。

另请注意，该代码片段会抛出：

java.lang.AssertionError: 
Expected: not a collection containing not a string ending with "x"
     got: <[1x, 2x, 3x, 4z]>

这会列出整个列表，而不仅仅是不以“x”结尾的元素。

那么是否有一种惯用的方式：

• 断言每个元素以“x”结尾（没有双重否定）
• 在断言错误时，仅列出那些不以“x”结尾的元素

Answer 1

您正在寻找 everyItem()：

assertThat(
    Arrays.asList("1x", "2x", "3x", "4z"),
    everyItem(endsWith("x"))
);

这会产生一条不错的失败消息：

Expected: every item is a string ending with "x"
     but: an item was "4z"

Answer 2

David Harkness 给出的匹配器为预期部分生成了一条很好的消息。
然而，实际部分的消息还取决于您使用的 assertThat 方法：

来自 JUnit (org. junit.Assert.assertThat) 生成您提供的输出。

• 使用 not(hasItem(not(...))) 匹配器：

  java.lang.AssertionError： 
  预期：不是不包含以“x”结尾的字符串的集合
       得到：<[1x, 2x, 3x, 4z]>
  

• 使用 everyItem(...) 匹配器：

  java.lang.AssertionError： 
  预期：每个项目都是以“x”结尾的字符串
       得到：<[1x, 2x, 3x, 4z]>
  

来自 Hamcrest 的匹配器 (org.hamcrest.MatcherAssert.assertThat) 产生 David 给出的输出：

• 使用 not(hasItem(not(...))) 匹配器：

  java.lang.AssertionError： 
  预期：不是不包含以“x”结尾的字符串的集合
       但是：是<[1x, 2x, 3x, 4z]>
  

• 使用 everyItem(...) 匹配器：

  java.lang.AssertionError： 
  预期：每个项目都是以“x”结尾的字符串
       但是：一个项目是“4z”
  

我自己对 Hamcrest 断言的实验表明，“但是”部分经常令人困惑，具体取决于多个匹配器的精确程度组合起来，哪个先失败，因此我仍然坚持 JUnit 断言，我非常清楚我将在“得到”部分看到什么。

Answer 3

我知道这个问题已经很老了，但是今天，对于 Java 8，我宁愿用 lambda 来编写它，例如

Stream.of("1x", "2x", "3x", "4z").allMatch(e->e.endsWith("x"));

这就是原因。