终极指南：Truth核心组件详解——从BooleanSubject到IterableSubject的完整解析-编程实验室

终极指南：Truth核心组件详解——从BooleanSubject到IterableSubject的完整解析

【免费下载链接】truthFluent assertions for Java and Android项目地址: https://gitcode.com/gh_mirrors/tr/truth

Truth是一款强大的Java和Android断言库，提供流畅的断言API，帮助开发者编写更清晰、更易维护的测试代码。本文将深入解析Truth的核心组件，从基础的BooleanSubject到复杂的IterableSubject，带你掌握这款断言库的精髓。

什么是Truth？

Truth是由Google开发的开源断言库，它的设计理念是提供可读性强、表达力丰富的断言API。与JUnit自带的断言相比，Truth的断言方法更贴近自然语言，使得测试代码更易于理解和维护。

Truth的核心优势在于：

流畅的API设计，支持方法链调用
丰富的错误信息，便于调试
全面的类型支持，包括基本类型、集合、流等
可扩展性，支持自定义断言

核心组件概览

Truth提供了多种Subject类，每个类针对特定类型的对象提供断言方法。以下是一些常用的核心组件：

BooleanSubject：针对布尔值的断言
IntegerSubject：针对整数的断言
StringSubject：针对字符串的断言
IterableSubject：针对可迭代对象的断言
MapSubject：针对映射的断言
ThrowableSubject：针对异常的断言

接下来，我们将详细介绍其中两个重要的组件：BooleanSubject和IterableSubject。

BooleanSubject：简化布尔值断言

BooleanSubject是Truth中最简单也最常用的组件之一，它提供了针对布尔值的断言方法。

基本用法

BooleanSubject的主要方法包括：

isTrue()：断言值为true
isFalse()：断言值为false

使用示例：

assertThat(true).isTrue(); assertThat(false).isFalse();

实现原理

BooleanSubject的实现非常简洁，核心代码如下：

public final class BooleanSubject extends Subject { private final @Nullable Boolean actual; private BooleanSubject(FailureMetadata metadata, @Nullable Boolean actual) { super(metadata, actual); this.actual = actual; } public void isTrue() { if (actual == null) { isEqualTo(true); // fails } else if (!actual) { failWithoutActual(simpleFact("expected to be true")); } } public void isFalse() { if (actual == null) { isEqualTo(false); // fails } else if (actual) { failWithoutActual(simpleFact("expected to be false")); } } static Factory<BooleanSubject, Boolean> booleans() { return BooleanSubject::new; } }

从代码中可以看出，BooleanSubject处理了null值的情况，并提供了清晰的错误信息。这种设计确保了即使在处理可能为null的布尔值时，也能给出明确的失败原因。

IterableSubject：强大的集合断言

IterableSubject是Truth中最复杂也最强大的组件之一，它提供了丰富的方法来断言可迭代对象的各种特性。

主要功能

IterableSubject提供了多种断言方法，包括：

isEmpty() / isNotEmpty()：断言集合为空或非空
hasSize(int)：断言集合大小
contains(Object) / doesNotContain(Object)：断言集合包含或不包含某个元素
containsExactly(Object...)：断言集合包含 exactly 指定的元素
containsAtLeast(Object...)：断言集合至少包含指定的元素
isInOrder() / isInStrictOrder()：断言集合元素有序

高级用法

精确包含断言

使用containsExactly()方法可以断言集合包含 exactly 指定的元素，包括数量和类型：

assertThat(Arrays.asList(1, 2, 3)).containsExactly(3, 2, 1);

如果需要同时检查顺序，可以使用inOrder()：

assertThat(Arrays.asList(1, 2, 3)).containsExactly(1, 2, 3).inOrder();

元素对应断言

使用comparingElementsUsing()方法可以自定义元素比较规则：

assertThat(actualIterable) .comparingElementsUsing(correspondence) .contains(expectedElement);

实现原理

IterableSubject的实现非常复杂，包含了大量的逻辑来处理各种集合断言场景。核心功能包括：

空集合检查
大小检查
元素包含性检查
元素顺序检查
自定义比较规则

其中，containsExactly()方法的实现尤为复杂，需要处理元素的匹配、顺序检查以及详细的错误信息生成。

Truth的扩展能力

除了核心组件外，Truth还提供了多种扩展模块，以支持更多类型的断言：

proto：支持Protocol Buffers的断言
re2j：支持正则表达式的断言
java8：支持Java 8特性的断言

这些扩展可以通过Maven或Gradle轻松添加到项目中。

快速开始使用Truth

要在项目中使用Truth，只需添加以下依赖：

Maven:

<dependency> <groupId>com.google.truth</groupId> <artifactId>truth</artifactId> <version>1.1.3</version> <scope>test</scope> </dependency>

Gradle:

testImplementation 'com.google.truth:truth:1.1.3'

然后就可以在测试代码中使用Truth的断言了：

import static com.google.common.truth.Truth.assertThat; public class MyTest { @Test public void testSomething() { assertThat("hello").startsWith("h"); assertThat(Arrays.asList(1, 2, 3)).contains(2); } }