教程 - 在 JVM 平台使用 JUnit 进行代码测试

添加依赖项

1. 在 IntelliJ IDEA 中打开一个 Kotlin 项目. 如果你还没有项目, 请 创建一个新项目.

2. 打开 build.gradle(.kts) 文件, 检查是否有 testImplementation 依赖项. 通过这个依赖项, 你将可以使用 kotlin.test 和 JUnit:

   dependencies { // 其他依赖项. testImplementation(kotlin("test")) }

   dependencies { // 其他依赖项. testImplementation 'org.jetbrains.kotlin:kotlin-test' }

3. 向 build.gradle(.kts) 文件添加 test 任务:

   tasks.test { useJUnitPlatform() }

   test { useJUnitPlatform() }

下面是 build.gradle.kts 的完整代码:

添加需要测试的代码

1. 打开 src/main/kotlin 中的 Main.kt 文件.

   src 目录包含 Kotlin 源代码文件和资源文件. Main.kt 文件包含示例代码, 它会打印输出 Hello, World!.

2. 创建 Sample 类, 包含 sum() 函数, 它会将两个整数加在一起:

   class Sample() { fun sum(a: Int, b: Int): Int { return a + b } }

创建测试

1. 在 IntelliJ IDEA 中, 对 Sample 类选择 Code | Generate | Test...:

   

2. 输入测试类的名称. 比如, SampleTest.

   IntelliJ IDEA 会在 test 目录中创建 SampleTest.kt 文件. 这个目录包含 Kotlin 测试源代码文件和资源文件.

3. 在 SampleTest.kt 中为 sum() 函数添加测试代码:

   • 使用 @Test 注解, 定义测试函数 testSum().

   • 使用 assertEquals() 函数, 检查 sum() 函数是否返回了期待的值.

   import org.example.Sample import org.junit.jupiter.api.Assertions.* import kotlin.test.Test class SampleTest { private val testSample: Sample = Sample() @Test fun testSum() { val expected = 42 assertEquals(expected, testSample.sum(40, 2)) } }

运行测试

1. 使用源代码编辑器侧栏中的图标运行测试:

   

2. 在 Run 工具窗口检查测试结果:

   

   测试函数执行成功了.

3. 将 expected 变量值修改为 43, 确认测试正确工作:

   @Test fun testSum() { val expected = 43 assertEquals(expected, classForTesting.sum(40, 2)) }

4. 再次运行测试, 并检查结果:

   

   测试执行失败.

下一步做什么?

完成你的第一个测试之后, 你可以:

• 使用 kotlin.test 的其他函数, 编写更多测试. 比如, 使用 assertNotEquals() 函数.

• 使用 Kotlin Power-assert 编译器 plugin 改进你的测试输出. 这个 plugin 使用上下文信息, 让测试输出更加详细丰富.

• 使用 Kotlin 和 Spring Boot 创建你的第一个服务器端应用程序.