How do Hamcrest's hasItems, contains and containsInAnyOrder differ?

夙愿已清 提交于 2019-11-27 09:57:27

问题


Hamcrest provides a number of matchers for asserting the contents of a collection. All of these cases pass:

Collection<String> c = ImmutableList.of("one", "two", "three");
assertThat(c, hasItems("one", "two", "three");
assertThat(c, contains("one", "two", "three");
assertThat(c, containsInAnyOrder("one", "two", "three");

How do hasItems, contains and containsInAnyOrder differ?


回答1:


hasItems checks:

consecutive passes over the examined Iterable yield at least one item that is equal to the corresponding item from the specified items.

That is, it makes sure that the collections contains at least these items, in any order. So,

assertThat(c, hasItems("one", "two"));

would also pass, with the extra item being ignored. And:

assertThat(c, hasItems("three", "two", "one"));

would also pass.

contains checks:

a single pass over the examined Iterable yields a series of items, each logically equal to the corresponding item in the specified items. For a positive match, the examined iterable must be of the same length as the number of specified items.

So it makes sure that the collection contains exactly these items:

assertThat(c, contains("one", "two")); // Fails

This would fail, as the leftover "three" is not matched.

assertThat(c, contains("three", "two", "one")); // Fails

This fails because the corresponding items don't match.

Another related matcher, containsInAnyOrder, checks that exactly those items are present, but in any order:

Creates an order agnostic matcher for Iterables that matches when a single pass over the examined Iterable yields a series of items, each logically equal to one item anywhere in the specified items.

A test with a missing item fails:

assertThat(c, containsInAnyOrder("one", "two")); // Fails

But all items in a different order will pass:

assertThat(c, containsInAnyOrder("three", "two", "one"));


来源:https://stackoverflow.com/questions/33840531/how-do-hamcrests-hasitems-contains-and-containsinanyorder-differ

标签
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!