You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Overview

Error formatting macro: snippet: java.lang.NullPointerException

The Code

In this example we develop a simple calculator stateless session EJB.

It is an EJB 3 style pojo stateless session bean
Every stateless session bean implementation must be annotated
using the annotation @Stateless or marked that way in a deployment descriptor.

The Stateless bean has 2 business interfaces: CalculatorRemote, a remote business
interface, and CalculatorLocal, a local business interface

Local business interface

@Local annotation

Note that it's not mandatory to annotate local business interfaces with the @Local annotation. If a business interface doesn't have any annotation, it's assumed to be local by the ejb container.

Error formatting macro: snippet: java.lang.NullPointerException

You'll notice that in EJB 3.0 the Local Business Interface of a stateless session bean does not need to extend from javax.ejb.EJBLocalObject and does not need a javax.ejb.EJBLocalHome interface. When the bean is looked up from JNDI, the container will create a new reference and pass it to the caller. No home interface required.

Remote business interface
Error formatting macro: snippet: java.lang.NullPointerException

As stated above, the Remote Business Interface of a bean can be any plain old interface. It does not need to extend javax.ejb.EJBObject, it does not need a javax.ejb.EJBHome, the methods do not need to throw javax.rmi.RemoteException, and the bean class can implement it!

Bean
Error formatting macro: snippet: java.lang.NullPointerException

In EJB 3.0 session beans do not need to implement the javax.ejb.SessionBean interface. You can simply annotate it as @Stateless if you want it to be a stateless session bean. And as noted above, notice the bean is actually implement the business interfaces! In the prior version of EJB implementing the remote interface (which derives from javax.ejb.EJBObject) in your bean was just not allowed. Now there is no javax.ejb.EJBObject requirement, so implementing the business interfaces is standard practice for EJB 3.0.

Writing a unit test for the example

Writing an unit test for the stateless session EJb is quite simple. We need just to write a setup method to create and initialize the InitialContext, and then write our test methods

setUp

Error formatting macro: snippet: java.lang.NullPointerException

Note the "openejb.deployments.classpath.include" parameter, which tells the ejb container to search for EJBs in the classpath, and specifies in which java packages they are to be located.

Test the local business interface

Error formatting macro: snippet: java.lang.NullPointerException

Test the remote business interface

Error formatting macro: snippet: java.lang.NullPointerException

Running

Running the example is fairly simple, just run:

$ cd calculator-stateless-pojo
$ mvn clean install

Which should create output like the following.

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
[surefire] Running org.apache.openejb.examples.calculator.CalculatorTest
log4j:WARN No appenders could be found for logger (OpenEJB).
log4j:WARN Please initialize the log4j system properly.
Apache OpenEJB 3.0-incubating-SNAPSHOT    build: 20070105-12:45
http://incubator.apache.org/openejb
OpenEJB ready.
[surefire] Tests run: 2, Failures: 0, Errors: 0, Time elapsed: 2.371 sec
[INFO] [jar:jar]
[INFO] Building jar: openejb3/examples/calculator-stateless-pojo/target/simple-calculator-stateless-1.0-SNAPSHOT.jar
[INFO] [install:install]
[INFO] Installing openejb3/examples/calculator-stateless-pojo/target/simple-calculator-stateless-1.0-SNAPSHOT.jar ...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
  • No labels