EJBContainerRunner or test with EJBContainer easily

To test a EE application you have several solutions. One of them is to use EJBContainer.

EJBContainer container = EJBContainer.createEJBContainer(properties);
// do test
container.close();

These steps are often in a test lifecycle (@BeforeClass/@AfterClass for JUnit for instance).

With OpenEJB you also have:

container.getContext().bind("inject", this);

This allows you to get injections (@Inject, @Resource, @PersistenceContext…) in the test class.

That’s nice but you can make it easier!

Since some versions OpenEJB provides in openejb-junit module a runner to do more or less these steps.

Here is the dependency:

<dependency>
  <groupId>org.apache.openejb</groupId>
  <artifactId>openejb-junit</artifactId>
  <version>${openejb.version}</version>
  <scope>test</scope>
</dependency>

Then just write a standard JUnit test with EJBContainerRunner:

package org.superbiz;

import org.apache.openejb.junit.jee.EJBContainerRunner;
import org.junit.Test;
import org.junit.runner.RunWith;

import javax.inject.Inject;

import static org.junit.Assert.assertEquals;

@RunWith(EJBContainerRunner.class)
public class MyBeanTest {
    @Inject
    private MyBean bean;

    @Test
    public void sayHi() {
        assertEquals("Hello!", bean.hi());
    }
}

This is already great but you can go further configuring the container (properties):

// @PropertyFile if you want to reuse properties
@Properties({
    @Property(key = "myDataSource", value = "new://Resource?type=DataSource")
})
@RunWith(EJBContainerRunner.class)
public class MyBeanTest {
    @Inject
    private MyBean bean;

    @Resource(name = "myDataSource")
    private DataSource myDs;

    // ...tests
}

On test side you can control if the test is executed under a transaction or not:

@Test
@Transaction(rollback = true)
public void myTest() {
    // ...
}

Finally there are some test oriented injections to get the container Context (to do lookups), container properties or the container itself:

@RunWith(EJBContainerRunner.class)
public class MyBeanTest {
    @TestResource
    private Context ctx;

    @TestResource
    private Hashtable<String, ?> props;

    @TestResource
    private EJBContainer container;

    // ...
}

Want more content ? Keep up-to-date on my new blog

Or stay in touch on twitter @rmannibucau