Nested class lifecycle in JUnit

Introduction

Nested class lifecycle helps organize tests in groups and control how often setup and cleanup happen for each group.

You want to group related tests inside a main test class.

You need separate setup for different groups of tests.

You want to run setup once per group instead of before every test.

You want clearer test reports showing test groups.

You want to avoid repeating setup code for similar tests.

Syntax

JUnit

import org.junit.jupiter.api.*;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
class OuterTest {

    @BeforeAll
    void beforeAllOuter() {
        // runs once before all tests in OuterTest
    }

    @Nested
    @TestInstance(TestInstance.Lifecycle.PER_CLASS)
    class InnerTest {

        @BeforeAll
        void beforeAllInner() {
            // runs once before all tests in InnerTest
        }

        @Test
        void testSomething() {
            // test code
        }
    }
}

Use @Nested to create a nested test class inside an outer test class.

Lifecycle annotations like @BeforeAll run once per class instance.

Examples

This example shows a nested class with setup before each test inside it.

JUnit

import org.junit.jupiter.api.*;

class OuterTest {

    @BeforeAll
    static void setupAll() {
        System.out.println("Setup once for all tests");
    }

    @Nested
    class GroupOne {

        @BeforeEach
        void setupEach() {
            System.out.println("Setup before each test in GroupOne");
        }

        @Test
        void testA() {
            System.out.println("Running testA");
        }
    }
}

Using @TestInstance(PER_CLASS) allows @BeforeAll to be non-static in nested classes.

JUnit

import org.junit.jupiter.api.*;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
class OuterTest {

    @Nested
    @TestInstance(TestInstance.Lifecycle.PER_CLASS)
    class InnerTest {

        @BeforeAll
        void init() {
            System.out.println("Init once for InnerTest");
        }

        @Test
        void testOne() {
            System.out.println("Test one running");
        }
    }
}

Sample Program

This test class has two nested groups: AdditionTests and SubtractionTests. Setup methods run at different times for each group. Assertions check correct math results.

JUnit

import org.junit.jupiter.api.*;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
class CalculatorTest {

    @BeforeAll
    void setupAll() {
        System.out.println("Setup for all tests");
    }

    @Nested
    @TestInstance(TestInstance.Lifecycle.PER_CLASS)
    class AdditionTests {

        @BeforeAll
        void setupAddition() {
            System.out.println("Setup for addition tests");
        }

        @Test
        void testAddPositive() {
            int result = 2 + 3;
            Assertions.assertEquals(5, result);
            System.out.println("testAddPositive passed");
        }

        @Test
        void testAddNegative() {
            int result = -1 + -1;
            Assertions.assertEquals(-2, result);
            System.out.println("testAddNegative passed");
        }
    }

    @Nested
    class SubtractionTests {

        @BeforeEach
        void setupSubtraction() {
            System.out.println("Setup before each subtraction test");
        }

        @Test
        void testSubtract() {
            int result = 5 - 3;
            Assertions.assertEquals(2, result);
            System.out.println("testSubtract passed");
        }
    }
}

Important Notes

Nested classes help keep tests organized and readable.

Use @TestInstance(TestInstance.Lifecycle.PER_CLASS) to allow non-static @BeforeAll in nested classes.

Setup in outer class runs before nested class setups.

Summary

Nested classes group related tests inside a main test class.

Lifecycle annotations control setup and cleanup timing per class or test.

Using nested lifecycle improves test organization and efficiency.

Practice

1. In JUnit 5, what is the purpose of using a @Nested class inside a test class?

easy

A. To group related tests together for better organization

B. To run tests in parallel automatically

C. To disable tests temporarily

D. To create a separate test suite file

Solution

1. Step 1: Understand the role of @Nested

   The @Nested annotation allows grouping related test methods inside inner classes to organize tests logically.

2. Step 2: Compare other options

   The other options describe unrelated features: disabling tests temporarily, running tests in parallel automatically, and creating separate test suite files, which are not the purpose of @Nested.

3. Final Answer:

   To group related tests together for better organization -> Option A

4. Quick Check:

   @Nested groups tests = C [OK]

Hint: Remember: @Nested groups tests inside main class [OK]

Common Mistakes:

• Thinking @Nested runs tests in parallel
• Confusing @Nested with @Disabled
• Assuming @Nested creates separate test files

2. Which lifecycle annotation is used to run a method once before all tests in a @Nested class?

easy

A. @BeforeAll

B. @AfterAll

C. @AfterEach

D. @BeforeEach

Solution

1. Step 1: Identify lifecycle annotations for nested classes

   In JUnit 5, @BeforeAll runs once before all tests in the class, including nested classes if used inside them.

2. Step 2: Differentiate from other annotations

   @BeforeEach runs before each test method, not once; @AfterEach and @AfterAll run after tests, so they don't fit the requirement.

3. Final Answer:

   @BeforeAll -> Option A

4. Quick Check:

   Run once before all tests = @BeforeAll [OK]

Hint: Before all tests in nested class use @BeforeAll [OK]

Common Mistakes:

• Using @BeforeEach instead of @BeforeAll for once-only setup
• Confusing @AfterAll with setup annotations
• Not placing @BeforeAll inside nested class

3. Consider this JUnit 5 test structure:

class OuterTest {
  @BeforeAll
  static void setupOuter() { System.out.println("Outer setup"); }

  @Nested
  class InnerTest {
    @BeforeAll
    static void setupInner() { System.out.println("Inner setup"); }

    @Test
    void testOne() { System.out.println("Test one"); }
  }
}

What will be the order of printed lines when running testOne()?

medium

A. Inner setup\nOuter setup\nTest one

B. Outer setup\nInner setup\nTest one

C. Outer setup\nTest one\nInner setup

D. Test one\nOuter setup\nInner setup

Solution

1. Step 1: Understand lifecycle order in nested classes

   The @BeforeAll in the outer class runs first, then the @BeforeAll in the nested class, followed by the test method.

2. Step 2: Trace the print statements

   First prints "Outer setup", then "Inner setup", then "Test one" as per the method calls.

3. Final Answer:

   Outer setup\nInner setup\nTest one -> Option B

4. Quick Check:

   Outer before all, then inner before all, then test [OK]

Hint: Outer @BeforeAll runs before nested @BeforeAll [OK]

Common Mistakes:

• Assuming nested @BeforeAll runs before outer
• Mixing order of test and setup prints
• Forgetting static requirement for @BeforeAll in nested

4. Given this nested test class, what is the error that prevents @BeforeAll from running?

class OuterTest {
  @Nested
  class InnerTest {
    @BeforeAll
    void setup() { System.out.println("Setup"); }

    @Test
    void test() { System.out.println("Test"); }
  }
}

medium

A. Missing @Test annotation on setup method

B. @BeforeAll cannot be used inside nested classes

C. @BeforeAll method must be static in nested classes

D. InnerTest class must be static

Solution

1. Step 1: Check @BeforeAll method requirements in nested classes

   In JUnit 5, @BeforeAll methods inside nested classes must be static unless the nested class is annotated with @TestInstance(Lifecycle.PER_CLASS).

2. Step 2: Analyze the given code

   The @BeforeAll method is non-static and the nested class is not annotated with @TestInstance, so this causes a runtime error.

3. Final Answer:

   @BeforeAll method must be static in nested classes -> Option C

4. Quick Check:

   @BeforeAll in nested must be static unless @TestInstance used [OK]

Hint: @BeforeAll in nested classes must be static [OK]

Common Mistakes:

• Thinking @BeforeAll cannot be used in nested classes
• Forgetting static keyword on @BeforeAll method
• Confusing @BeforeAll with @BeforeEach

5. You want to run a setup method once before all tests in both the outer and nested classes without making the nested class static. Which approach correctly achieves this in JUnit 5?

hard

A. Move all tests to the outer class and remove nested classes

B. Make the nested class static and keep @BeforeAll method static

C. Use @BeforeEach instead of @BeforeAll in nested class

D. Annotate the nested class with @TestInstance(Lifecycle.PER_CLASS) and make the @BeforeAll method non-static

Solution

1. Step 1: Understand static requirement for @BeforeAll in nested classes

   By default, @BeforeAll methods in nested classes must be static because nested classes are instance classes.

2. Step 2: Use @TestInstance(Lifecycle.PER_CLASS) to allow non-static @BeforeAll

   Annotating the nested class with @TestInstance(Lifecycle.PER_CLASS) changes lifecycle so @BeforeAll can be non-static, allowing setup without static nested class.

3. Step 3: Evaluate other options

   Make the nested class static and keep @BeforeAll method static requires static nested class, which is not desired. Use @BeforeEach instead of @BeforeAll in nested class changes setup frequency. Move all tests to the outer class and remove nested classes removes nested structure, losing organization.

4. Final Answer:

   Annotate the nested class with @TestInstance(Lifecycle.PER_CLASS) and make the @BeforeAll method non-static -> Option D

5. Quick Check:

   @TestInstance(PER_CLASS) allows non-static @BeforeAll in nested [OK]

Hint: Use @TestInstance(PER_CLASS) to avoid static @BeforeAll in nested [OK]

Common Mistakes:

• Making nested class static when not needed
• Using @BeforeEach instead of @BeforeAll for once-only setup
• Removing nested classes to fix lifecycle issues