一、Hamcrest简介

  Hamcrest是一个用于编写匹配器(matcher)对象的框架,允许以声明方式定义“匹配(match)”规则。它可以与JUnit框架配合使用,使断言可读更高,更加灵活(例如判断数组、集合、map中的内容等)。

Hamcrest支持多种语言,本文只使用JAVA语言。Hamcrest官网:http://hamcrest.org/

二、Java Hamcrest 常用匹配器

    @Test
public void testAssertThatWithHamcrest() { /**
* 核心:
*/
//anything:总是匹配,如果你不关心测试下的对象是什么是有用的
assertThat("随便是个啥", anything("总是匹配就完事了"));
//describedAs:添加一个定制的失败表述装饰器
assertThat("zs", describedAs("自定义故障描述",equalTo("zs")));
//is:改进可读性装饰器 ,底层is(equalTo(value))
assertThat("zs",is("zs")); /**
* 逻辑:
*/
//allOf:所有匹配器都匹配才匹配,相当于 &&
assertThat("张三", allOf(startsWith("张"), containsString("三")));
//anyOf:任何匹配器匹配就匹配,相当于 ||
assertThat("张三",anyOf(startsWith("李"),containsString("三")));
// not:包装的匹配器不匹配器时匹配,相当于与取反
assertThat("tom",not("lucy")); /**
* 对象:
*/
//equalTo:测试对象相等使用Object.equals方法
assertThat("foo", equalTo("foo"));
//hasToString:测试Object.toString方法
assertThat(true, hasToString(equalTo("true")));
//instanceOf, typeCompatibleWith:测试类型
assertThat("string", instanceOf(String.class));
assertThat(Integer.class, typeCompatibleWith(Number.class));
//notNullValue, nullValue:测试null
assertThat(null,nullValue());
assertThat("",notNullValue());
//sameInstance:测试对象实例
Integer number = new Integer(200);
assertThat(number,sameInstance(number)); /**
* Beans:
*/
@Data
class MyClass{
private String name;
}
//hasProperty:测试JavaBeans属性
assertThat(new MyClass(),hasProperty("name")); /**
* 集合:
*/
//array:测试一个数组元素,每一项是否匹配
assertThat(new Integer[]{1,2,3}, is(array(equalTo(1), equalTo(2), equalTo(3))));
//hasEntry, hasKey, hasValue :测试一个Map包含一个实体,键或者值
Map<String,Integer> map = new HashMap<>();
map.put("张三",23);
map.put("李四",24);
assertThat(map,hasEntry("张三",23));
assertThat(map,hasKey("李四"));
assertThat(map,hasValue(23));
//hasItem, hasItems:测试一个集合包含一个元素
assertThat(Arrays.asList("foo", "bar"),hasItem(startsWith("ba")));
assertThat(Arrays.asList("foo", "bar", "baz"), hasItems(endsWith("z"), endsWith("o")));
//hasItemInArray:测试一个数组包含一个元素
assertThat(new String[] {"foo", "bar"}, hasItemInArray(startsWith("ba"))); /**
* 数字:
*/
// closeTo:测试浮点值接近给定的值,该匹配器在+/-error范围内匹配
assertThat(1.03, is(closeTo(1.0, 0.04)));
//greaterThan, greaterThanOrEqualTo, lessThan, lessThanOrEqualTo :测试次序
assertThat(2, greaterThan(1));
assertThat(1, greaterThanOrEqualTo(1));
assertThat(1, lessThan(2));
assertThat(1, lessThanOrEqualTo(1)); /**
* 文本:
*/
//equalToIgnoringCase:测试字符串相等忽略大小写
assertThat("Foo", equalToIgnoringCase("FOO"));
//equalToIgnoringWhiteSpace:测试字符串忽略空白
assertThat(" my\tfoo bar ", equalToIgnoringWhiteSpace(" my foo bar"));
//containsString, endsWith, startsWith:测试字符串匹配
assertThat("myStringOfNote", containsString("ring"));
assertThat("myStringOfNote", endsWith("Note"));
assertThat("myStringOfNote", startsWith("my")); }

三、自定义匹配器

示例代码:

import org.hamcrest.Description;
import org.hamcrest.Matcher;
import org.hamcrest.TypeSafeMatcher; /**
* 自定义匹配器,判断年龄范围在[1,200]返回true
* 1、继承TypeSafeMatcher并指定泛型
* 2、重写matchesSafely、describeTo方法
* 3、提供外部调用的静态方法
*/
public class IsNormalAgeRange extends TypeSafeMatcher<Integer> { @Override
public boolean matchesSafely(Integer number) {
return number >=1 && number <=200;
} @Override
public void describeTo(Description description) {
description.appendText("need to be within [1,200]");
} public static Matcher normalAgeRange() {
return new IsNormalAgeRange();
} }

测试:

    @Test
public void testMyMatcher() {
assertThat(100, IsNormalAgeRange.normalAgeRange());
}

最新文章

  1. 使用PhpStrom等IDE编辑 远程linux服务器上的文件 实时更新
  2. git操作之常见问题解决方案
  3. T4模板——一个神奇的代码生成器
  4. C++函数模版
  5. Import user&#39;s Environment path into Linux cron task
  6. 关于cocos2dx 3.0升级崩溃报错(unable to load native library) 和(Fatal signal 11 (SIGSEGV) at 0x00000000)
  7. 分布式版本控制系统Git-----7.Git 使用git rebase合并多次commit
  8. Java数据库 高级查询
  9. 《程序员面试金典(第5版)》【PDF】下载
  10. Repair MySQL 5.6 GTID replication by injecting empty transactions
  11. JavaSE-基本数据类型
  12. Spring MVC配置实例
  13. Mysql连接查询、子查询、联合查询 整理
  14. 《Linux就该这么学》今天开课了-Linux的发展,起源
  15. JS 原型链 prototypt 和隐式原型 _proto_
  16. 转---如何让前端更安全?——XSS攻击和防御详解
  17. POJ1611(KB2-B)
  18. HDU 4847 陕西邀请赛A(水)
  19. Spring MVC @RequestParam @RequestHeader @CookieValue用法
  20. 谈谈&quot;求线段交点&quot;的几种算法(js实现,完整版)

热门文章

  1. navcat for mysql 连接远程数据库 教程
  2. os、sys和shutil模块
  3. fuse的write过程到底是怎么样的,128KB的buffer怎么用?
  4. Xcode清楚缓存、清理多余证书路径
  5. C++中volatile及编译器优化
  6. NFS (网络文件系统)
  7. BZOJ_2726_[SDOI2012]任务安排_斜率优化+二分
  8. 如何在单独的窗口中打开 Excel 文件
  9. UI:数据库练习、滤镜效果
  10. Unity3D模型制作规范[转]