起初我并不喜欢断言库。 测试框架提供的断言是否足够尚有争议。 但是这些库提供了一种编写更接近业务语言的自定义断言的方法。 虽然意图值得称赞,但我一直以为这条路很滑。 如果有人开始编写这样的自定义断言,那么显然需要对其进行测试。 然后,什么时候停止?
但是,与测试框架提供的断言库相比,无可否认的断言库使编写断言更加流畅。 此外,我不记得最近几年有任何具有自定义声明的项目。 因此,我倾向于假定大多数开发人员具有相同的推理,并且使用那些断言库是相当安全的。
断言库的当前状态
当我开始意识到断言库时,有两个主要的竞争者:
- FEST断言 。 它是更大的FEST套件的一部分,其中包括一个非常流行的Swing测试库。 目前,FEST不再处于积极发展中。
- Hamcrest 。 Hamcrest是可用于所有主要语言(Java,Python,Ruby等)的断言库。 几年前,它已成为断言的参考库。
甚至没有引用Google Truth的清单就不会完整。 但是,无论Google品牌如何,我都觉得它从未受到任何关注。
但是,两年前,我正在从事的项目团队决定将AssertJ用于断言。 我不知道为什么,而且我可能错了,但是AssertJ似乎在当今很受欢迎。 检查Github上的相应 回购信息还发现,与AssertJ相比,Hamcrest提交的内容更大,但更稀疏。 最后,AssertJ为Guava,Joda Time,Neo4J,Swing(!)和数据库提供了特定的断言。
在本文中,我想比较3个库:
样本模型
在下面的内容中,我将使用从AssertJ文档中不客气的模型:
data classTolkienCharacter(valname:String,
valrace:Race,
valage:Int?=null)
enumclassRace(vallabel:String){
HOBBIT("Hobbit"),MAN("Man"),ELF("Elf"),DWARF("Dwarf"),MAIA("Maia")
}
valfrodo=TolkienCharacter("Frodo",HOBBIT,33)
valsam=TolkienCharacter("Gimli",DWARF)
valsauron=TolkienCharacter("Sauron",MAIA)
valboromir=TolkienCharacter("Boromir",MAN,37)
valaragorn=TolkienCharacter("Aragorn",MAN)
vallegolas=TolkienCharacter("Legolas",ELF,1000)
valfellowshipOfTheRing=listOf(
boromir,
TolkienCharacter("Gandalf",MAN),
aragorn,
TolkienCharacter("Sam",HOBBIT,38),
TolkienCharacter("Pippin",HOBBIT),
TolkienCharacter("Merry",HOBBIT),
frodo,
sam,
legolas)
AssertJ的功能
要开始使用AssertJ,只需将以下依赖项添加到POM:
<dependency>
<groupId> org.assertj </groupId>
<artifactId> assertj-core </artifactId>
<version> 3.11.1 </version>
<scope> test </scope>
</dependency>
在最基本的级别上,AssertJ允许检查是否相等和相同:
@Test
fun`assertthatfrodo'snameisequaltoFrodo`(){
assertThat(frodo.name).isEqualTo("Frodo")
}
@Test
fun`assertthatfrodoisnotsauron`(){
assertThat(frodo).isNotSameAs(sauron)
}
Kotlin允许函数名称包含空格字符,前提是该名称由反引号分隔。 这对于断言名称非常有用。
AssertJ还对字符串提供了不同的断言:
@Test
fun`assertthatfrodo'snamestartswith