Business Case

The example explains how a real-life business problem could be solved using OpenEJB in a combination with other open-source frameworks and tools. The example covers the entire software development lifecycle, starting from problem analysis, architecture, design, build automation, unit testing, implementation, and deployment.

The product is hosted at http://oss.rempl.com and its source code is available at http://svn.rempl.com/trunk/rempl/rempl-oss. The purpose of this system is to collect UML meta information from open source products. The information collected has to become visible for end-users in form of diagrams and texts.

Architecture and Design

The following components are used in the system:

OpenEJB as an implementation of EJB
OpenJPA, an implementation of JPA
Jersey, implementation of JAX-RS
Mojarra, implementation of Java Server Faces (JSF)

There are a number of service layers in the system:

Presentation Layer includes JSF (Mojarra), JAX-RS (Jersey), and JEE container (Tomcat). In other words, everything on top of "Delegates" in the diagram. More about

Business Layer includes EJB (OpenEJB), Brokers (Stateless Session Beans), and JPA entities.

Persistence Layer includes JPA (OpenJPA), JDBC (MySQL JDBC Driver) and the MySQL server.

Build Automation and Tests

Build automation is managed by Maven 3, see our pom.xml.

There are four levels of testing in the product:

Static analysis
Out-of-container unit testing
In-container functional testing
On-location testing

During static analysis we are using Checkstyle, PMD, FindBugs, Cobertura, maven-dependency-plugin, xml-maven-plugin. Important to note that all these tools are used as gate condition checkers, not as post-factum analyzers.

Out-of-container tests are automated with JUnit. Good example of a Stateless Session Bean out-of-container testing: UserMgrBeanTest.java.

In-containter functional testing is automated with JSFUnit and embedded Tomcat container. more later...

On-location testing is not yet automated... working on it...

Configuration and Plumbing

TBD...

Implementation