如何为基于XSLT的XML转换Java代码编写JUnit单元测试用例

第一步：重构原业务代码，提升可测试性 #

原代码逻辑完全耦合在main方法中，且硬编码了文件路径，无法直接进行单元测试，先抽离核心转换逻辑：

import javax.xml.transform.*;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
import java.io.File;
import java.io.IOException;
import java.net.URISyntaxException;

public class XmlTransformer {
    // 抽离通用转换方法，支持自定义输入输出源，适配测试场景
    public void transform(Source xsltSource, Source inputXmlSource, Result outputResult) throws TransformerException {
        TransformerFactory factory = TransformerFactory.newInstance();
        Transformer transformer = factory.newTransformer(xsltSource);
        transformer.transform(inputXmlSource, outputResult);
    }

    // 保留原有main方法的业务逻辑不变
    public static void main(String[] args) throws IOException, URISyntaxException, TransformerException {
        XmlTransformer transformer = new XmlTransformer();
        Source xslt = new StreamSource(new File("transform.xslt"));
        Source input = new StreamSource(new File("input.xml"));
        transformer.transform(xslt, input, new StreamResult(new File("output.xml")));
    }
}

第二步：准备测试前置资源 #

在项目的test/resources目录下存放三类测试文件：

• 测试用的简化版XSLT文件：test-transform.xslt
• 已知固定内容的输入XML文件：test-input.xml
• 预期输出的标准XML文件：test-expected-output.xml

第三步：引入所需依赖（以Maven为例） #

搭配XMLUnit做XML内容比对，可避免空格、换行、属性顺序不同导致的测试误判，在pom.xml中添加如下测试依赖：

<!-- JUnit5 核心依赖 -->
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.9.2</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.9.2</version>
    <scope>test</scope>
</dependency>
<!-- XMLUnit 依赖用于XML语义比对 -->
<dependency>
    <groupId>org.xmlunit</groupId>
    <artifactId>xmlunit-core</artifactId>
    <version>2.9.1</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.xmlunit</groupId>
    <artifactId>xmlunit-matchers</artifactId>
    <version>2.9.1</version>
    <scope>test</scope>
</dependency>

第四步：编写JUnit测试代码 #

import org.junit.jupiter.api.Test;
import org.xmlunit.builder.Input;
import org.xmlunit.diff.DifferenceEvaluators;
import org.xmlunit.matchers.CompareMatcher;
import javax.xml.transform.Source;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import static org.hamcrest.MatcherAssert.assertThat;

public class XmlTransformerTest {

    private final XmlTransformer transformer = new XmlTransformer();

    @Test
    public void testXsltTransform() throws Exception {
        // 从测试资源目录加载测试文件
        InputStream xsltStream = getClass().getResourceAsStream("/test-transform.xslt");
        InputStream inputStream = getClass().getResourceAsStream("/test-input.xml");
        InputStream expectedStream = getClass().getResourceAsStream("/test-expected-output.xml");

        // 用字节流承接输出，无需生成本地文件，提升测试执行效率
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();

        // 执行转换逻辑
        transformer.transform(
                new StreamSource(xsltStream),
                new StreamSource(inputStream),
                new StreamResult(outputStream)
        );

        // 比对实际输出和预期输出，忽略非语义差异
        Source actualSource = Input.fromByteArray(outputStream.toByteArray()).build();
        Source expectedSource = Input.fromStream(expectedStream).build();
        assertThat(actualSource, CompareMatcher.isSimilarTo(expectedSource)
                .withDifferenceEvaluator(DifferenceEvaluators.ignorePrologDifferences())
                .ignoreWhitespace()
                .ignoreComments()
                .normalizeWhitespace()
        );
    }
}

注意事项 #

• 不要直接比对XML的字符串内容，使用XMLUnit的语义比对逻辑，可自动过滤空白字符、注释、属性顺序等非核心差异
• 测试用资源统一从类路径加载，不要使用绝对路径，保证不同环境下测试都可正常执行
• 测试场景下优先使用字节流/字符流承接输出，不需要操作本地磁盘，测试执行速度更快

内容的提问来源于stack exchange，提问作者Shilpa