TestEE.fi

TestEE.fi (as in "testify") is a lightweight functional testing framework for Java-EE applications.

By conveniently integrating a fully blown CDI implentation (TestEE.fi internally uses Weld, the CDI reference implementation) with much loved mocking frameworks like Mockito and EasyMock and proven database setup tools like Flyway and Liquibase it offers a natural way to write tests for your Java-EE application the same way you write your unit tests. And by integrating with test-runtimes like JUnit 4 & 5 or Cucumber JVM it allows you to run your tests directly from your preferred IDE and build tool - at speeds very close to unit-level testing.

Getting started

Getting started with TestEE.fi is really easy. First you need to add TestEE.fi to your project’s dependencies. In Maven this looks like the following snippet:

<dependencies>
    <dependency>
        <groupId>fi.testee</groupId>
        <artifactId>testeefi-junit4-all</artifactId>
        <version>0.6.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.1.7</version>
        <scope>test</scope>
    </dependency>
</dependencies>

If you’re using Gradle, the snippet would look like this:

repositories {
    mavenCentral()
}
dependencies {
	testCompile 'fi.testee:testeefi-junit4-all:0.6.1'
	testCompile 'ch.qos.logback:logback-classic:1.1.7'
}

All you need to do now is to annotate your JUnit 4 test case like this:

@RunWith(TestEEfi.class)
public class MyTest {
	@Mock
	private ExternalSystemBean externalSystem;
	@Inject
	private FacadeBean facadeToTest;
	
	@Test
	public void runTest() {
		// Your test code
	}
}

Introduction and tutorials

The series of blog articles "Functional testing Java-EE applications with TestEE.fi" serves the purpose of introductory tutorials very well:

• Part 1: Introduction
• Part 2: Mocking with Mockito and EasyMock
• Part 3: JDBC and JPA
• Part 4: Cucumber JVM
• Part 5: JAX-RS and REST resources
• Part 6: JUnit 5
• Part 7: Static resources and Selenium (coming soon)
• Part 8: JMS and MDBs (coming soon)

Example projects

There's also a number of example projects based on a Gradle build that demonstrate the usage of TestEE.fi. You can find them in a separate repository.