在Java项目中，文件上传功能常常需要接收XML格式的数据，而保障上传处理逻辑正确的关键手段就是编写断言测试。AssertJ提供了优雅的API，可以帮助我们验证解析后的XML内容是否满足业务规则。
为什么用AssertJ验证XML上传内容
传统的JUnit断言在处理嵌套XML节点时语句繁琐，出错时提示不直观。AssertJ支持链式调用，能清晰表达期望，例如直接断言某个节点文本等于指定值。
测试基本思路
整体流程分为三步：
- 调用上传接口或方法，获取XML字节流或临时文件
- 使用JDK自带的DocumentBuilder将内容解析为Document对象
- 利用AssertJ对Document中的节点、属性做断言
代码示例
下面是一个使用JUnit 5和AssertJ验证上传XML内容的测试示例：
import org.junit.jupiter.api.Test;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import java.io.ByteArrayInputStream;
import static org.assertj.core.api.Assertions.assertThat;
public class XmlUploadTest {
@Test
void should_verify_uploaded_xml_content() throws Exception {
// 模拟上传接收到的XML字符串
String xml = "<?xml version="1.0"?><user><name>张三</name><age>20</age></user>";
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
Document doc = builder.parse(new ByteArrayInputStream(xml.getBytes("UTF-8")));
Element root = doc.getDocumentElement();
// 断言根元素名称
assertThat(root.getTagName()).isEqualTo("user");
NodeList nameNodes = root.getElementsByTagName("name");
// 断言子节点存在且文本正确
assertThat(nameNodes.getLength()).isEqualTo(1);
assertThat(nameNodes.item(0).getTextContent()).isEqualTo("张三");
NodeList ageNodes = root.getElementsByTagName("age");
assertThat(Integer.parseInt(ageNodes.item(0).getTextContent())).isGreaterThan(18);
}
}
验证属性与层级
如果XML带有属性，比如<user id="1001">，可以用如下方式断言：
import org.w3c.dom.Element;
import static org.assertj.core.api.Assertions.assertThat;
// 假设root为user元素
Element userEl = (Element) doc.getElementsByTagName("user").item(0);
assertThat(userEl.getAttribute("id")).isEqualTo("1001");
常见注意点
在测试时，要注意XML的命名空间问题。如果上传的XML带有命名空间，解析和获取节点时需使用带命名空间的方法，否则可能取不到节点。另外，建议将XML解析工具封装成独立方法，使测试更简洁。
编写断言测试不仅是为了通过用例，更是为了在发生格式变更时快速暴露不兼容问题。
小结
通过AssertJ配合标准DOM解析，开发者能以少量代码完成对XML文件上传内容的精确验证，提升测试维护性与可靠性。