Hamcrest 总结

太过爱你忘了你带给我的痛 2022-05-08 13:42 84阅读 0赞

### Junit ###

JUnit框架用一组assert方法封装了一些常用的断言。这些assert方法可以帮我们简化单元测试的编写。这样的话，Junit就可以根据这些断言是否抛出 AssertionFailedError 错误来判断测试用例的执行结果。

Hamcrest

使用过Junit 的应该有过体验：在实际开发中，一些基本的断言，如eqaul,null,true它们的可读性并不是很好。而且很多时候我们要比较对象、集合、Map等数据结构。这样我们要么进行大段的字段获取再断言。或者干脆自己编写表达式并断言其结果。  
JUnit4.4引入了Hamcrest框架，Hamcest提供了一套匹配符Matcher，这些匹配符更接近自然语言，可读性高，更加灵活。

Hamcrest 提供了大量被称为“匹配器”的方法。其中每个匹配器都设计用于执行特定的比较操作。Hamcrest的可扩展性很好，让你能够创建自定义的匹配器。最重要的是，JUnit也包含了Hamcrest的核心，提供了对Hamcrest的原生支持，可以直接使用Hamcrest。当然要使用功能齐备的Hamcrest，还是要引入对它的依赖。

看个对比例子，前者使用Junit的 断言，后者使用 Hamcrest的断言。

@Test
        public void test_with_junit_assert() {
            int expected = 51;
            int actual = 51;
     
            assertEquals("failure - They are not same!", expected, actual);
        }
     
        @Test
        public void test_with_hamcrest_assertThat() {
            int expected = 51;
            int actual = 51;
     
            assertThat("failure - They are not same!", actual, equalTo(expected));
        }

个人感觉有两个明显的区别：  
1. 参数顺序。两者的expected 和 actual 前后顺序是相反的。  
2. Hamcrest 几乎总是直接使用对象。它的语法更符合函数式编程的风格。  
这点很好理解了，Junit 总是获取值后再比较，因为比较的是简单的值，因此被比较的放在前面更符合习惯。  
而Hamcrest 是直接对测试结果的对象进行一些更复杂的匹配。

支持语言

Hamcrest 支持以下几种语言，详情见http://hamcrest.org/  
Java  
Python  
Ruby  
Objective-C  
PHP  
Erlang  
Swift

Hamcrest匹配器

Hamcrest 提供了很强大的一些api 供我们进行测试断言。

核心：
        anything - 总是匹配,如果你不关心测试下的对象是什么是有用的
        describedAs - 添加一个定制的失败表述装饰器
        is - 改进可读性装饰器 - 见下 “Sugar”
    逻辑：
        allOf - 如果所有匹配器都匹配才匹配,像Java里的&&
        anyOf - 如果任何匹配器匹配就匹配,像Java里的||
        not - 如果包装的匹配器不匹配器时匹配,反之亦然
    对象：
        equalTo - 测试对象相等使用Object.equals方法
        hasToString - 测试Object.toString方法
        instanceOf, isCompatibleType - 测试类型
        notNullValue, nullValue - 测试null
        sameInstance - 测试对象实例
    Beans：
        hasProperty - 测试JavaBeans属性
    集合：
        array - 测试一个数组元素test an array’s elements against an array of matchers
        hasEntry, hasKey, hasValue - 测试一个Map包含一个实体,键或者值
        hasItem, hasItems - 测试一个集合包含一个元素
        hasItemInArray - 测试一个数组包含一个元素
    数字：
        closeTo - 测试浮点值接近给定的值
        greaterThan, greaterThanOrEqualTo, lessThan, lessThanOrEqualTo - 测试次序
    文本：
        equalToIgnoringCase - 测试字符串相等忽略大小写
        equalToIgnoringWhiteSpace - 测试字符串忽略空白
        containsString, endsWith, startsWith - 测试字符串匹配

这些API 几乎覆盖了我们测试断言的所有情况。再提供良好阅读性的情况下，减少了一些取值、循环、类型判断等代码的编写。

转自：[hustzw07][]

[hustzw07]: https://blog.csdn.net/hustzw07/article/details/79145253