其实在之前的文章中已经使用过 Hamcrest 匹配器框架,本篇文章将系统的介绍它的使用.

为什么要用Hamcrest匹配器框架

Hamcrest是一款软件测试框架, 可以通过现有的匹配器类检查代码中的条件.也可以通过自定义的匹配器实现.

要在JUnit中使用Hamcrest匹配器,可以用它的assertThat语句,并且可添加一个或多个匹配器.

Hamcrest一般被视作第三代匹配器框架.第一代使用断言(逻辑语句),但这样的测试不易读.第二代测试框架引入了特殊的断言方法,例如assertEquals().然而这种方式会导致编写过多类似的断言方法.Hamcrest采用了assertThat方法和匹配器表达式来确定测试是否成功,解决上述两个缺点.

Hamcrest的目标是使测试尽可能的提高可读性.例如is()方法其实就是equalTo()的包装方法.

下面的代码就是一个使用Hamcrest的案例.

package com.lulu.androidtestdemo.hamcrest;
import org.junit.Test;
import static org.junit.Assert.assertEquals;
import static org.hamcrest.MatcherAssert.assertThat;
import static org.hamcrest.Matchers.*; /**
* Created by lulu on 2018/3/17.
*/
public class TestHamcrest {
boolean a;
boolean b;
@Test
public void testHamcrest() throws Exception {
//下面语句的测试目的是一致的
assertThat(a, equalTo(b));
assertThat(a, is(equalTo(b)));
assertThat(a, is(b));
}
}

下面代码比较了一下pure JUnit 4和使用Hamcrest的断言语句.

// JUnit 4 for equals check
assertEquals(expected, actual);
// Hamcrest for equals check
assertThat(actual, is(equalTo(expected))); // JUnit 4 for not equals check
assertNotEquals(expected, actual);
// Hamcrest for not equals check
assertThat(actual, is(not(equalTo(expected))));

也可以通过anyOf()等方法实现匹配器的链接.

assertThat("test", anyOf(is("testing"), containsString("est")));

通常Hamcrest的错误信息也更容易阅读.(下图为Pure JUnit 4和Hamcrest错误log的对比)

assertTrue(result instanceof String);
// error message:
java.lang.AssertionError
at org.junit.Assert.fail(Assert.java:86)
at org.junit.Assert.assertTrue(Assert.java:41)
at org.junit.Assert.assertTrue(Assert.java:52)
// ... assertEquals(String.class, result.getClass());
// error message:
java.lang.NullPointerException
at com.vogella.hamcrest.HamcrestTest.test(HamcrestTest.java:30)
// .... assertThat(result, instanceOf(String.class));
// error message:
java.lang.AssertionError:
Expected: an instance of java.lang.String
but: null
at org.hamcrest.MatcherAssert.assertThat(MatcherAssert.java:20)
at org.hamcrest.MatcherAssert.assertThat(MatcherAssert.java:8)
// ...

使用Hamcrest匹配器也具备更高的类型安全性, 因为它们都使用了泛型.

添加Hamcrest依赖

对于Android Studio,需要在build.gradle中添加:

dependencies {
// Unit testing dependencies
testImplementation 'junit:junit:4.12'
// Set this dependency if you want to use Hamcrest matching
testImplementation 'org.hamcrest:hamcrest-library:1.3'
}

使用Hamcrest

示例

Hamcrest匹配器的示例如下所示

assertThat(Long.valueOf(1), instanceOf(Integer.class));
// shortcut for instanceOf
assertThat(Long.valueOf(1), isA(Integer.class));

静态导入

使用静态导入可以使得所有匹配器都可用,更方便开发人员找到合适的匹配器.

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

一些重要的Hamcrest匹配器

下面是一些非常重要且常用的Hamcrest匹配器

  • allOf - 所有匹配条件都匹配则通过
  • anyOf - 任何一个匹配条件匹配则通过
  • not - 与匹配条件违背则通过
  • equalTo - 使用Object.equals方法测试对象相等
  • is - 与equalTo相同,仅用来提高代码可读性
  • hasToString - 测试 Object.toString方法
  • instanceOf,isCompatibleType - 测试类型
  • notNullValue,nullValue - 测试null
  • sameInstance - 测试是否是同一实例
  • hasEntry,hasKey,hasValue - 测试一个Map包含entry,key或者value
  • hasItem,hasItems - 测试一个集合包含对应元素
  • hasItemInArray - 测试一个数组包含某个元素
  • closeTo - 测试浮点值接近于给定值
  • greaterThan, greaterThanOrEqualTo, lessThan, lessThanOrEqualTo
  • equalToIgnoringCase - 测试字符串相等且忽略大小写
  • equalToIgnoringWhiteSpace - 测试字符串相等且忽略空白符
  • containsString, endsWith, startsWith - 匹配字符串

详细请看Hamcrest API: http://hamcrest.org/JavaHamcrest/javadoc/1.3/org/hamcrest/Matchers.html

使用Hamcrest内置的匹配器

集合匹配器测试集合

测试目标

假设存在下列代码:

List<Integer> list = Arrays.asList(5, 2, 4);

通过使用Hamcrest匹配器对这个list进行下列验证:

  • 大小为3
  • 包含2, 4, 5三个元素,忽略顺序
  • 每个元素都大于1

测试代码

@Test
public void hasSizeOf3() {
List<Integer> list = Arrays.asList(5, 2, 4); assertThat(list, hasSize(3));
}
@Test
public void containsNumbersInAnyOrder() {
List<Integer> list = Arrays.asList(5, 2, 4); assertThat(list, containsInAnyOrder(2, 4, 5));
}
@Test
public void everyItemGreaterThan1() {
List<Integer> list = Arrays.asList(5, 2, 4); assertThat(list, everyItem(greaterThan(1)));
}

集合匹配器验证数组

测试目标

假设存在下列代码:

Integer[] ints = new Integer[] {7, 5, 12, 16};

通过使用Hamcrest匹配器对这个ints数组进行下列验证:

  • 长度为4
  • 以特定的顺序含有7, 5, 12, 16元素

测试代码

@Test
public void arrayHasSizeOf4() {
Integer[] ints = new Integer[] { 7, 5, 12, 16 }; assertThat(ints, arrayWithSize(4));
}
@Test
public void arrayContainsNumbersInGivenOrder() {
Integer[] ints = new Integer[] { 7, 5, 12, 16 }; assertThat(ints, arrayContaining(7, 5, 12, 16));
}

Hamcrest beans匹配器

测试目标

假设存在下面的类:

public class Todo {
private final long id;
private String summary;
private String description;
private int year; public Todo(long id, String summary, String description) {
this.id = id;
this.summary = summary;
this.description = description;
}
//getter 和 setter
}

通过使用Hamcrest匹配器进行下列验证:

  • Todo类含有名叫 “summary”的属性
  • 如果Todo类被创建时给summary属性传入”Learn Hamcrest”, 则summary属性会用这个值进行初始化
  • 两个对象用相同的值创建,会有相同的属性值

测试代码

    @Test
public void objectHasSummaryProperty () {
Todo todo = new Todo(1, "Learn Hamcrest", "Important");
assertThat(todo, hasProperty("summary"));
}
    @Test
public void objectHasCorrectSummaryValue () {
Todo todo = new Todo(1, "Learn Hamcrest", "Important");
assertThat(todo, hasProperty("summary", equalTo("Learn Hamcrest")));
}
    @Test
public void objectHasSameProperties () {
Todo todo1 = new Todo(1, "Learn Hamcrest", "Important");
Todo todo2 = new Todo(1, "Learn Hamcrest", "Important");
assertThat(todo1, samePropertyValuesAs(todo2));
}

字符串匹配器

实现下列对字符串的检查:

  • “”是一个空字符串
  • 一个给定的字符串不是空或者null
    @Test
public void isStringEmpty() {
String stringToTest = "";
assertThat(stringToTest, isEmptyString());
}
    @Test
public void isStringEmptyOfNull() {
String stringToTest = "";
assertThat(stringToTest, isEmptyOrNullString());
}

原文地址:https://blog.csdn.net/u013144863/article/details/79940039

Hamcrest匹配器框架的更多相关文章

  1. Junit 断言 assertThat Hamcrest匹配器

    junit断言总结本文参考了http://blog.csdn.net/wangpeng047/article/details/9628449一 junit断言1.JUnit框架用一组assert方法封 ...

  2. 前端测试框架Jest系列教程 -- Matchers(匹配器)

    写在前面: 匹配器(Matchers)是Jest中非常重要的一个概念,它可以提供很多种方式来让你去验证你所测试的返回值,本文重点介绍几种常用的Matcher,其他的可以通过官网api文档查看. 常用的 ...

  3. Mockito 2 参数匹配器

    Mockito 通过使用 equals() 这种自然的 Java 样式来校验参数值.有时候,当需要有其他一些灵活性的时候,你可能会要求使用参数匹配(argument matchers). 请参考下面的 ...

  4. JUnit4---Hamcrest匹配器常用方法总结

    一.Hamcrest是什么? Hamcrest is a library of matchers, which can be combined in to create flexible expres ...

  5. [Google Guava]字符串处理:连接器、拆分器、字符匹配器

    一.连接器[Joiner] 二.拆分器[Splitter] 三.字符匹配器[CharMatcher] 四.字符集[Charsets] Charsets:针对所有Java平台都要保证支持的六种字符集提供 ...

  6. EassyMock实践 自定义参数匹配器

    虽然easymock中提供了大量的方法来进行参数匹配,但是对于一些特殊场合比如参数是复杂对象而又不能简单的通过equals()方法来比较,这些现有的参数匹配器就无能为力了.easymock为此提供了I ...

  7. Flask入门之自定义过滤器(匹配器)

    1.  动态路由的匹配器? 不知道这种叫啥名,啥用法,暂且叫做匹配器吧. Flask自带的匹配器可以说有四种吧(保守数字,就我学到的) 动态路由本身,可以传任何参数字符串或者数字,如:<user ...

  8. 【Jest】笔记二:Matchers匹配器

    一.前言 什么是匹配器? 我们可以把匹配器看成,testng断言,这么理解就可以了 二.常用的匹配器 test('two plus two is four', () => { expect(2 ...

  9. BF匹配器

    对于BF匹配器,首先我们得用cv2.BFMatcher()创建BF匹配器对象.它取两个可选参数,第一个是normType.它指定要使用的距离量度.默认是cv2.NORM_L2.对于SIFT,SURF很 ...

随机推荐

  1. javascript正则表达式知识大全

    什么是正则表达式 正则表达式(regular expression)是一个描述字符模式的对象.ECMAScript的RegExp类表示正则表达式,而String和RegExp都定义了使用正则表达式进行 ...

  2. HTML 5适合小公司,适合在大平台上做内容

    Web App,现在有时候也称为轻应用,不仅是通过浏览器就能打开的应用.现在随着 HTML 5 在手机端的优越性,已经慢慢称为了 Web App 的主流.Web App 除了出现在 PC 的浏览器中, ...

  3. 装了ubuntu之后,只能进入ubuntu系统,不能进入windows系统

    电脑之前安装的是Windows 7系统, 后来在安装Linux系统中(快要完成)出现了故障, 没办法只能关机,之后重启,重启后只能进入Linux系统了 解决方案: 使用sudo update-grub ...

  4. UVA_458:The Decoder

    Language:C++ 4.8.3  PS:ASCII值减去七 #include<stdio.h> #include<string.h> int main(void) { c ...

  5. UVa 825【简单dp,递推】

    UVa 825 题意:给定一个网格图(街道图),其中有一些交叉路口点不能走.问从西北角走到东南角最短走法有多少种.(好像没看到给数据范围...) 简单的递推吧,当然也就是最简单的动归了.显然最短路长度 ...

  6. 一维数组的求平均成绩 Day06

    package com.sxt.arraytest1; /* * 求班里学生的平均成绩,以及成绩的综合 输出每个同学的成绩 */ import java.util.Arrays; import jav ...

  7. 14 个你可能不知道的 JavaScript 调试技巧

    了解你的工具可以极大的帮助你完成任务.尽管 JavaScript 的调试非常麻烦,但在掌握了技巧 (tricks) 的情况下,你依然可以用尽量少的的时间解决这些错误 (errors) 和问题 (bug ...

  8. Layout布局(补充)

    HBoxLayout和VBoxLayout HBoxLayout和VBoxLayout布局都比较简单,也叫箱式布局,它按照先后顺序进行横向布局或垂直布局.另外这两种布局也提供了pack属性支持,设置内 ...

  9. jsp获取后端java路由返回值

    html: <input type="hidden" id="tableName" value="${id}"> javascr ...

  10. HDU1358 Period 题解 KMP算法

    题目链接:http://acm.hdu.edu.cn/showproblem.php?pid=1358 题目大意:给你一个长度为 \(n\) 的字符串 \(s\) ,那么它有 \(n\) 个前缀. 对 ...