What are fixtures?

Fixtures in the context of testing, especially in Java using frameworks like JUnit or TestNG, are the state of the test environment prepared before executing test methods and cleaned up after their completion.

They are used for:

• Setting up initial conditions: Creating necessary objects, connecting to databases, configuring mocks, etc.
• Maintaining isolation: Ensuring that each test runs in a clean and predictable environment, independent of other tests.
• Saving time: Avoiding code duplication for environment setup in each test.

JUnit offers annotations for managing fixtures:

• @BeforeAll (or @BeforeClass in JUnit 4): Executed once before all test methods in the class. Used for setting up resources that are costly to create (e.g., establishing a database connection).
• @BeforeEach (or @Before in JUnit 4): Executed before each test method. Used for creating objects specific to each test.
• @AfterEach (or @After in JUnit 4): Executed after each test method. Used for cleaning up resources after a test.
• @AfterAll (or @AfterClass in JUnit 4): Executed once after all test methods in the class. Used for closing resources opened in @BeforeAll.

Example of usage in JUnit 5:

// imports

class MyServiceTest {

    private MyService myService;
    private Connection dbConnection;

    @BeforeAll
    static void setupDatabaseConnection() {
        // Establish database connection once
        // dbConnection = DriverManager.getConnection("jdbc:...");
        System.out.println("Database connection established.");
    }

    @AfterAll
    static void closeDatabaseConnection() {
        // Close database connection once
        // if (dbConnection != null) dbConnection.close();
        System.out.println("Database connection closed.");
    }

    @BeforeEach
    void setUpEachTest() {
        // Create a new instance of the service before each test
        myService = new MyService(/* dependency injection */);
        System.out.println("MyService instance created.");
    }

    @AfterEach
    void tearDownEachTest() {
        // Clear state or reset mocks after each test
        myService = null;
        System.out.println("MyService instance cleared.");
    }

    @Test
    void testMethod1() {
        // Test logic using myService
        System.out.println("Executing testMethod1");
    }

    @Test
    void testMethod2() {
        // Test logic using myService
        System.out.println("Executing testMethod2");
    }
}