AssertJ 字符序列断言新增否定序列匹配方法解析

在 Java 测试领域，AssertJ 作为流行的断言库，近期在其字符序列断言功能中新增了两个重要方法：doesNotContainSequence 和 doesNotContainSubsequence。这两个方法的加入完善了字符序列的否定匹配能力，使得测试验证更加全面。

方法设计背景

AssertJ 原本在 AbstractIterableAssert 中已提供类似的序列匹配方法，但在字符序列断言中一直缺少对应的否定验证方法。这种不对称性会导致在某些测试场景中，开发者需要编写额外的逻辑来验证字符串不包含特定序列或子序列。

方法功能详解

doesNotContainSequence 方法

该方法用于验证目标字符串中不连续出现指定的字符序列。其特点是要求多个字符串必须按照给定顺序紧密连接出现才会触发断言失败。

典型使用场景：

String json = "{ 'name':'John', 'age':30 }";
// 通过验证
assertThat(json).doesNotContainSequence("name", "30"); 
// 失败验证（因为"name"和"'John'"连续出现）
assertThat(json).doesNotContainSequence("name", "'John'");

doesNotContainSubsequence 方法

该方法比前者更宽松，只要字符串中按顺序出现指定的字符序列（不要求连续），就会触发断言失败。

典型使用场景：

String log = "Error:404 at line 30";
// 通过验证
assertThat(log).doesNotContainSubsequence("404", "line 20");
// 失败验证（因为"Error"和"line"按顺序出现）
assertThat(log).doesNotContainSubsequence("Error", "line");

技术实现要点

1. 序列匹配算法：底层采用改进的字符串搜索算法，确保在大文本中也能高效查找
2. 空值处理：对null输入有明确的异常抛出机制
3. 边界处理：正确处理零长度字符串和空序列的情况
4. 性能优化：避免不必要的字符串拷贝操作

实际应用价值

这两个方法特别适用于：

• REST API响应验证
• 日志内容检查
• 配置文件校验
• 数据格式验证

例如在测试API响应时，可以明确验证某些特定信息不会以特定形式出现在响应中：

String apiResponse = getSecuredApiResponse();
assertThat(apiResponse)
    .doesNotContainSubsequence("password", "123456");

版本兼容性

新方法从AssertJ 3.24.0开始提供，使用时需要确保项目依赖的AssertJ版本符合要求。对于需要向后兼容的情况，可以考虑使用isNotSubstringOf等现有方法组合实现类似功能。