JUnit 5の適用方法

JUnit 5のビルド環境作成、Spring BootでのJUnit 5適用環境
Tags:

ビルド環境

Gradle環境では、次のようなビルドファイル(build.gradle)が必要である。

build.gradle

plugins {
    id 'java'
}

group 'com.devkuma'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
}

test {
    useJUnitPlatform()
}
  • 依存関係としてorg.junit.jupiter:junit-jupiter-apiが必要である。

IDEでプロジェクトを作成すると、次のようなディレクトリ構造になる。

.
├── build.gradle
├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── devkuma
    │   │           └── Main.java
    │   └── resources
    └── test
        ├── java
        └── resources

テストコードの作成

/src/test/java/com/devkuma/junit5/JUnit5Test.java

package com.devkuma.junit5;

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

class JUnit5Test {
    @Test
    void success() {
        Assertions.assertEquals(3, 3);
    }

    @Test
    void fail() {
        Assertions.assertEquals(3, 5);
    }

    static class StaticTest {
        @Test
        void success() {
            Assertions.assertEquals(3, 3);
        }

        @Test
        void fail() {
            Assertions.assertEquals(3, 5);
        }
    }

    class InnerTest {
        @Test
        void success() {
            Assertions.assertEquals(3, 3);
        }

        @Test
        void fail() {
            Assertions.assertEquals(3, 5);
        }
    }
}

Spring Bootでの適用方法

Spring Boot 2.2以降ではJUnit 5が標準で提供されている。JUnit 5を使う場合、追加設定なしでstarter-testに含まれる。

Spring Boot 2.2.x以降

testImplementation("org.springframework.boot:spring-boot-starter-test")
 
test {
    useJUnitPlatform()
}

Spring Boot 2.2.x以前

testImplementation("org.springframework.boot:spring-boot-starter-test") {
     exclude module : 'junit' 
}

testImplementation("org.junit.jupiter:junit-jupiter-api")
testCompile("org.junit.jupiter:junit-jupiter-params")
testRuntime("org.junit.jupiter:junit-jupiter-engine")

test {
     useJUnitPlatform() 
}