Testing

Active Objects integrates with JUnit to make your entity testing easy.

The first thing to do is add a dependency to your project. When using Maven, this means:

Testing dependencies

1
2
<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>4.8.1</version>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>net.java.dev.activeobjects</groupId>
  <artifactId>activeobjects-test</artifactId>
  <version>${ao.version}</version>
  <scope>test</scope>
</dependency>

Tests of Active Objects entities look like the following, taken from the DogFood blog:

Testing Active Objects

1
2
@RunWith(ActiveObjectsJUnitRunner.class) // (1)
@Data(AoBlogServiceTest.AoBlogServiceTestDatabaseUpdater.class) // (2)
@Jdbc(DerbyEmbedded.class) // (3)
@NameConverters // (4)
public final class AoBlogServiceTest
{
    private EntityManager entityManager; // (5)

    private AoBlogService blogService;

    @Before
    public void setUp() throws Exception
    {
        blogService = new AoBlogService(entityManager);
    }

    @Test
    public void getBlogCreatesOneIfNecessary() throws Exception // (6)
    {
        assertEquals(0, entityManager.find(Blog.class).length); // no blogs
        assertNotNull(blogService.getBlog());
    }

    public static final class AoBlogServiceTestDatabaseUpdater implements DatabaseUpdater // (2)
    {
        @Override
        public void update(EntityManager entityManager) throws Exception
        {
            entityManager.migrate(Blog.class, Post.class, Comment.class, Label.class, PostToLabel.class);
        }
    }
}

1. Using the ActiveObjectsJUnitRunner makes testing ActiveObjects entities easy.
2. Specifying a DatabaseUpdater through the @Data annotation. It is implemented here as a static inner class (AoBlogServiceTestDatabaseUpdater). Its update method allows you to prepare the database for tests. It is called only once per class (or per set of classes with the same DatabaseUpdater).
3. Specifying the database to use for testing, here an embedded Derby database. A convenient class to re-use for Maven users is the net.java.ao.test.jdbc.DynamicJdbcConfiguration, which will determine the database in use according to a System property. Combined with Maven profiles, it makes it easy to test against any database.
4. Active Objects uses name converters to translate entity names and properties to table and column names. This @NameConverters annotation allows setting the converter used for tests. Here the defaults are used. Note that the annotation can be omitted.
5. The EntityManager is injected by the ActiveObjectsJUnitRunner, which allows instantiating the class under test with a properly configured entity manager.
6. A simple test. Note that all test methods are wrapped in a transaction that is rolled back after the method has been run. This will leave the database in the exact same state before each test, whatever happens within the individual test.

1
2
<dependency>
  <groupId>com.atlassian.activeobjects</groupId>
  <artifactId>activeobjects-test</artifactId>
  <version>${ao.version}</version>
  <scope>test</scope>
</dependency>

1
2
@NameConverters(table = com.atlassian.activeobjects.test.TestActiveObjectsTableNameConverter
                field = com.atlassian.activeobjects.test.TestActiveObjectsFieldNameConverter)