JUnit 5

• https://mvnrepository.com/artifact/org.junit
• AssertJ
• Mockito
• JUnit Pioneer
• JUnit 5 Tutorials - Mkyong.com

• 테스트 코드 작성을 위한 API와, 그렇게 작성한 테스트를 수행하는 Engine을 분리하였다.

• JUnit 4 API로 작성한 코드도 JUnit 5에서 실행가능하다.
• 이 경우 junit-vintage-engine 으로 해당 코드를 수행한다.

• JUnit 5는 junit-jupiter-api로 테스트 코드를 작성하고
• junit-jupiter-engine으로 테스트 코드를 수행한다.

• Using JUnit 5 with Gradle | Baeldung
• Gradle 4.6 버전 이상 사용.
• Gradle과 함께 사용시

  test {
      useJUnitPlatform()
  }
   
  // spring-boot-starter-test 로 의존성 지정시
  testImplementation('org.springframework.boot:spring-boot-starter-test') {
      exclude group: 'org.junit.vintage', module: 'junit-vintage-engine' // junit4 지원 제외
  }

• @DisplayName(“설명”) : 테스트 설명을 일반 텍스트로 지정 가능. 가독성이 높아짐.
• @Disabled(“설명”) : 테스트 안하게 함. 설명도 지정.
• @Disabled*(“설명”) : @Disabled 로 시작하는 여러 애노테이션들. 해당 조건에 따라 테스트 안하게 함. 설명도 지정.
• @BeforeAll : 테스트 클래스 초기화시 한 번 실행
• @BeforeEach : 모든 테스트 메소드 실행 직전 실행
• @Test : 테스트
• @AfterEach : 모든 테스트 메소드 실행 직후 실행
• @AfterAll : 테스트 클래스가 종료될 때 실행
• @Nested : 중첩 클래스에 지정. 중첩 테스트가 만들기.
• @Tag : 클래스나 메서드에 붙인다. 테스트 실행시 특정 태그가 붙은 것만 실행/제외 할 수 있다.

• assumTrue : boolean 인자가 true 일 때만 테스트 실행
• assumFalse : boolean 인자가 false 일 때만 테스트 실행
• assumeThat(boolean/BooleanSupplier, Executable) : boolean 이 true이면 executable lambda 실행

• Refactor → Migrate Packages and Classes → JUnit (4.x → 5.0) 을 실행하여 리팩토링을 바로 실행할 수 있다.
• 그 이후 @RunWith(MockitoJUnitRunner.class) → @ExtendWith(MockitoExtension.class) 같은 종류를 찾아서 직접 변경해준다.
  • Structural Replace를 사용하면 쉽게 된다.
  • 변경된 파일들을 모두 선택하고 Organize Imports(Ctrl+Alt+o)를 해주는게 좋다.
• 기존 Mockito 테스트를 전환 할 경우 @MockitoSettings(strictness = Strictness.LENIENT) 설정이 필요한 경우가 많이 발생했음. 단, 되도록 이 설정을 없애도록 테스트를 수정할것.
• Test(expected = SomeException.class) 을 JUnit 5의 예외 테스트로 변경한다.
  • Structural Search를 사용한다.
  • Live Templates 에서 다음과 같이 만든다.
    • Applicable : Java(모두)
    • Abbreviation : assertex
    • Description : JUnit 5 assertThrows
    • Reformat according to style : check
    • Use static import if possible : check
    • Shorten FQ names : check
    • Edit Variables → EXCEPTION
      • Expression : clipboard()

org.junit.jupiter.api.Assertions.assertThrows($EXCEPTION$.class, () -> {
$SELECTION$
});

• 테스트 대상 예외 클래스의 이름을 복사(Ctrl+C)한 뒤에 예외 발생 코드를 선택하고 Ctrl+Alt+J로 단축키 실행.
• junit-vintage-engine와 junit:4.x 의존성을 완전히 삭제하고서(exclude 처리가 필요할 수 있음), 그상황에서 컴파일 오류 등을 잡아낸다.
• 특히, Assert 관련해서 junit 4 를 계속보고 있는게 발견되었다. jupiter Assertions나 hamcrest와 AssertJ 등으로 전환한다.
• 테스트 클래스 중에 public class에서 public을 제거하고 package private 로 전환한다. 이 과정에서 공통 테스트 라이브러리는 public 등으로 유지해야하므로 주의한다.
• package private 으로 전환하면 불필요하게 테스트 클래스가 자동완성으로 나오는 일 등이 줄어든다.

• Migrating from JUnit 4 to JUnit 5 – IntelliJ IDEA Blog | JetBrains
• IntelliJ IDEA. Migrating from JUnit 4 to JUnit 5 - YouTube
• Missing "JUnit 4 tests can be JUnit 5" inspection and migration action. : IDEA-291948
• IntelliJ IDEA inspection 으로 자동 마이그레이션
• Settings → Editor → Inspections : JVM languages → JUnit 4 test can be JUnit 5 항목이 켜져 있어야 한다.
• JUnit 4 테스트 클래스에서 Alt+Enter 로 Inspection 수행해서 Migrate to JUnit 5 실행
• Alt+Enter로 inspection 이 잘 안된다면 Code → Analyze Code → Run Inspection by name 에서 “JUnit 4 tests can be JUnit 5” 를 선택해서 강제 Inspection 을 할 수 있다.

• Lifecycle of JUnit 5's Extension Model
• Embrace JUnit 5
• Migrating from JUnit 4 to JUnit 5
• A Guide to JUnit 5 Extensions
• What’s new in JUnit for Java testing
• JUnit 5 dynamic tests
• 자바캔(Java Can Do IT) :: JUnit 5 소개
• 자바캔(Java Can Do IT) :: JUnit 5 Jupiter API 추가 특징: Assumption, @Nested, 태깅과 필터링
• 자바캔(Java Can Do IT) :: Spring Boot 2와 JUnit 5 사용
• JUnit5 Programmatic Extension Registration with @RegisterExtension | Baeldung
• Take Unit Testing to the Next Level With JUnit 5 - DZone Java
• Introduction to Unit Tests in Java Using JUnit5 [Video] - DZone Java
• Using JUnit 5 with Gradle | Baeldung
• JUnit5 Assertion Migration Strategy - DZone Java
• JUnit 5 - Parameterized Tests - blog@CodeFX
• Mockito and JUnit 5 - Using ExtendWith | Baeldung
• JUnit 5 - Basics - DZone Java
• Embrace JUnit5 - DZone Java
• Spring-Based Apps: Migrating to JUnit 5 - DZone Java
• Guide to JUnit 5 Parameterized Tests | Baeldung
• JUnit 5: The Next Step in Automated Testing
• JUnit 5 Conditional Test Examples – Mkyong.com
• JUnit 5 Tagging and Filtering, @Tag examples – Mkyong.com
• blog-sample/README.md at master · cheese10yun/blog-sample
• Junit5 with Spring boot - Yun Blog | 기술 블로그
• JUnit 5 Timeouts Examples – Mkyong.com
• JUnit 5 Display Names – Mkyong.com
• JUnit 5 + AssertJ examples – Mkyong.com
• JUnit5로 계층 구조의 테스트 코드 작성하기 - 기계인간 John Grib
• JUnit 5 Tutorials - Mkyong.com
• JUnit 5 tutorial, part 1: Unit testing with JUnit 5, Mockito, and Hamcrest | JavaWorld
• JUnit 5 tutorial, part 2: Unit testing Spring MVC with JUnit 5 | JavaWorld
• JUnit 5.6 Makes Testing Easy with New Features
• Unit Testing of System.out.println() with JUnit | Baeldung
• [JUnit] JUnit5 사용법 - 기본 - Heee's Development Blog
• [JUnit] JUnit5 사용법 - Parameterized Tests - Heee's Development Blog
• Structured JUnit 5 testing - codecentric AG Blog
• Extending JUnit 5 | Java Code Geeks - 2020
• Parameterized Tests in JUnit 5 | Java Code Geeks - 2020
• stefanbirkner/system-lambda: System Lambda is a collection of functions for testing code that uses java.lang.System
• A Comprehensive Guide On JUnit 5 Extensions