如何在 Eclipse 中进行 JavaFX 模块化项目的 JUnit 测试？

在 Eclipse 中使用 Gradle 构建模块化 JavaFX 项目并运行 JUnit 测试

在拥抱模块化 Java 开发的世界时，你是否曾为在 Eclipse 中使用 Gradle 构建 JavaFX 项目并运行 JUnit 测试而感到困惑？ 特别是当你需要使用 Jlink 生成精简的可执行文件时，JUnit 测试似乎成了难以逾越的鸿沟。 本文将为你揭开迷雾，带你一步步配置 Gradle 构建脚本，最终实现在 Eclipse 中优雅地运行 JUnit 测试，并完美兼容 Jlink 功能。

探究问题根源

在深入解决方案之前，让我们先来看看问题的本质。

模块化 Java 项目引入了 module-info.java 文件来管理模块间的依赖关系。然而，Eclipse IDE 在处理模块路径时，将 src/main/java 和 src/test/java 视为两个独立的源代码文件夹，分别拥有各自的类路径。这就导致一个问题：当你在 src/test/java 中运行 JUnit 测试时，Eclipse 无法自动识别 src/main/java 中定义的模块，因此测试代码无法访问主代码中的类和资源，JUnit 测试自然也就无法顺利执行。

构建解决方案桥梁

为了解决这个问题，我们需要巧妙地修改 Gradle 构建脚本，将测试代码的编译路径添加到模块路径中，并确保 JUnit 库在测试运行时触手可及。

步骤一：修改 build.gradle 文件

打开你的 build.gradle 文件，将以下配置添加到其中：

plugins {
    id 'java-library'
    id 'application'
    id 'eclipse'
    id 'org.openjfx.javafxplugin' version '0.0.12'
    id 'org.beryx.jlink' version '2.12.0'
}

dependencies {
    testImplementation 'junit:junit:4.13'
}

javafx {
    version = "16"
    modules = [ 'javafx.controls', 'javafx.fxml' ]
}

mainClassName = "{your-package}.App"

// 为测试任务配置模块路径和依赖关系
testing {
    suites {
        test {
            // 将主代码模块添加到测试模块路径
            modulePath = modulePath.plus files(sourceSets.main.output.classesDirs)
            // 将JUnit库添加到测试运行时类路径
            useJUnitPlatform()
        }
    }
}

eclipse {
    classpath {
        file {
            whenMerged {
                entries.findAll { it.properties.kind.equals('lib') }.each { it.entryAttributes['module'] = 'true' }
            }
        }
    }
}

jlink {
    options = ['--strip-debug', '--compress', '2', '--no-header-files', '--no-man-pages']
    launcher {
        name = 'mini'
    }
}

// 将测试任务添加到构建生命周期
tasks.named('check') {
    dependsOn testing.suites.test
}

代码解析：

• testing.suites.test 块内的 modulePath = modulePath.plus files(sourceSets.main.output.classesDirs) 将主代码模块添加到测试模块路径，确保测试代码可以访问主代码。
• useJUnitPlatform() 将 JUnit 库添加到测试运行时类路径，为 JUnit 测试的运行提供必要的环境。
• tasks.named('check') { dependsOn testing.suites.test } 将测试任务集成到构建生命周期中，保证每次构建都会执行测试，确保代码质量。

步骤二：刷新 Gradle 项目

修改完 build.gradle 文件后，点击 Eclipse IDE 中的“Gradle”按钮，选择“Refresh Gradle Project”，让更改生效。

验证解决方案，畅享测试

完成以上步骤后，你就可以像运行普通 Java 项目一样，在 Eclipse IDE 中运行 JUnit 测试了。Eclipse 现在可以识别测试代码对主代码模块的依赖关系，并将 JUnit 库正确地添加到测试运行时类路径中。JUnit 测试的障碍已被清除，你可以自由地编写和运行测试，为你的 JavaFX 项目保驾护航。

常见问题解答

1. 为什么我的测试类仍然无法访问主代码中的类？

请确保你已经刷新了 Gradle 项目，并且你的测试代码中正确地引入了主代码中的类。

2. 使用 Jlink 生成可执行文件时，是否需要对构建脚本进行额外的配置？

不需要，上述配置已经兼容 Jlink，你可以直接使用 Jlink 生成可执行文件。

3. 我可以使用其他测试框架吗？

当然可以，你可以根据自己的喜好选择其他测试框架，例如 TestNG。

4. 如何调试 JUnit 测试？

你可以在 Eclipse IDE 中像调试普通 Java 代码一样调试 JUnit 测试，例如设置断点、单步执行等。

5. 我还有其他问题，可以在哪里寻求帮助？

你可以在 Gradle 和 Eclipse 的官方论坛上寻求帮助，也可以查阅相关的文档和教程。