介绍 Hamcrest

Hamcrest 是一个 Java 扩展库，提供了一种强大的“匹配器”框架，可用于编写易于阅读和编写的测试代码。它与 JUnit 和其他测试框架集成，易于使用。

安装

在 Maven 项目中添加以下依赖项：

<dependency>
    <groupId>org.hamcrest</groupId>
    <artifactId>hamcrest-all</artifactId>
    <version>1.3</version>
</dependency>

用法

创建一个 Matcher 需要实现 Matcher 接口，可以使用 Matcher 的内置实现之一，也可以创建自己的实现。

比如，可以使用内置的 IsEqual 实现，检查两个对象是否相等：

assertThat("foo", equalTo("foo"));

这将比较两个字符串，如果它们相等，则测试通过。

还可以使用 allOf、anyOf 和 not 方法来组合 Matcher。

assertThat("foo", allOf(startsWith("f"), containsString("o")));
assertThat("foo", anyOf(endsWith("o"), containsString("X")));
assertThat("foo", not(equalTo("bar")));

这些方法支持任意数量的 Matcher，并且在组合它们时提供更多的灵活性。

自定义 Matcher

有时，内置 Matcher 不能满足你的需求，你可能需要创建自己的 Matcher 实现。创建 Matcher 需要实现 Matcher 接口的 matches 方法。

比如，要检查集合是否包含特定元素，可以创建以下 Matcher：

public class ContainsElementMatcher<T> extends TypeSafeMatcher<Iterable<T>> {

    private final T element;

    public ContainsElementMatcher(T element) {
        this.element = element;
    }

    public void describeTo(Description description) {
        description.appendText("a collection containing ").appendValue(element);
    }

    @Override
    protected boolean matchesSafely(Iterable<T> items) {
        for (T item : items) {
            if (Objects.equals(item, element)) {
                return true;
            }
        }
        return false;
    }
}

使用以下代码测试：

List<String> list = Arrays.asList("foo", "bar", "baz");
assertThat(list, new ContainsElementMatcher<>("bar"));

如果列表包含 "bar"，则测试通过。

简化语法

Hamcrest 还提供了一种简化文法，使代码更容易阅读和编写。这些语法在静态导入中定义。

比如，可以使用以下静态导入使语法更直接：

import static org.hamcrest.CoreMatchers.*;
import static org.hamcrest.MatcherAssert.assertThat;

assertThat("foo", is("foo"));
assertThat("foo", not(is("bar")));

这将测试字符串是否等于 "foo"，并检查它是否不等于 "bar"。

结论

Hamcrest 是一个强大的 Java 扩展库，提供了灵活的 Matcher 框架，可简化编写和阅读测试代码。 它易于使用，并且可与 JUnit 和其他测试框架集成。