The following instructions are written using Eclipse 3.2. We will refer to the install location of OpenEJB as OPENEJB_HOME
Here are some basic steps you need to perform to get started with OpenEJB
- Download and install OpenEJB
- Setup your development environment
- Write an EJB
- Write an EJB client
- Start the server
- Deploy the EJB
- Run the client
- Stop the server
1. Download and Install OpenEJB
Follow these instructions![]()
2. Setup your development environment
Eclipse
- Open eclipse and create a new java project. Name it EJBProject
- Add the following jars to the build path of your project
- OPENEJB_HOME/lib/geronimo-ejb_3.0_spec-1.0.jar
- Now create another project named EJBClient. This is where we will write a test client
- Add the following jars to the build path of this project
- OPENEJB_HOME/lib/openejb-client-3.0.0-SNAPSHOT.jar
- Add the EJBProject to the classpath of the EJBClient project
3. Start the Server
Open the command prompt and run the following command:
d:\openejb-3.0.0-SNAPSHOT\bin\openejb start
You will get the following message on the console:
4. Write an EJB
In the EJB project create a new interface named Greeting
package com.myejbs;
import javax.ejb.Remote;
@Remote
public interface Greeting {
public String greet();
}
Now create a new class named GreetingBean which implements the above interface (shown below)
package com.myejbs;
import javax.ejb.Stateless;
@Stateless
public class GreetingBean implements Greeting {
public String greet() {
return "My First Remote Stateless Session Bean";
}
}
5. Deploy the EJB
#Export the EJBProject as a jar file. Name it greeting.jar and put it in the OPENEJB_HOME/apps directory.
#Open the command prompt and type in the following command:
d:\openejb-3.0.0-SNAPSHOT > bin\openejb deploy apps\greeting.jar
This should give you the following output:
Notice the Jndi(name=GreetingBeanBusinessRemote) information. Keep this handy as this is the JNDI name of the bean which the client will use for lookup
6. Write the Client
In the EJBClient project, create a class named Client (shown below)
package com.myclient;
import java.util.Properties;
import javax.naming.InitialContext;
import javax.naming.NamingException;
import javax.rmi.PortableRemoteObject;
import com.myejbs.Greeting;
public class Client {
public static void main(String[] args) {
try {
Properties p = new Properties();p.put("java.naming.factory.initial", "org.openejb.client.RemoteInitialContextFactory");
p.put("java.naming.provider.url", "127.0.0.1:4201");
InitialContext ctx = new InitialContext( p );
Object object = ctx.lookup("GreetingBeanBusinessRemote");
Greeting greeter = (Greeting) PortableRemoteObject.narrow(object, Greeting.class);
String message = greeter.greet();
System.out.println(message);
} catch (NamingException e) {
e.printStackTrace();
}
}
}
7. Run the Client
Open Client.java in eclipse and run it as a java application. You should see the following message in the console view:
8. Stop the server
You can press Ctrl+c on the command prompt to stop the server
