To run this tutorial, as a minimum you will be required to have installed the following prerequisite software:
- Sun JDK 5.0+ (J2SE 1.5)
- Eclipse IDE for Java EE Developers, which is platform specific
- Geronimo Eclipse Plugin 2.1.x
- Geronimo Server 2.1.x
Details on installing eclipse are provided in the Development environment section. This tutorial is organized in the following sections:
The application development will take you through the following:
Define New Geronimo Server Runtime
- Launch Eclipse and Select New-> Other-> Server -> Server and select Next.
- Select Apache -> Apache Geronimo v2.1 Server and select Next.
- Specify the installation directory of an existing Geronimo server installation and select Finish.
- Start the server in Eclipse from the J2EE perspective.
Creating a EJB Project
- Launch Eclipse and Right Click Under the Project Explorer. Select New->EJB Project.
- Name the project as CurrencyConvertEJB and Select Next.
- Use the default values and Select Finish.
- Right Click on ejbModule and Select New->Interface.
- Name the package as ejb and Interface as Converter. Select Finish.
- Right Click on ejb package and Select New->Class.
- Name the class as ConverterBean and select Finish.
Creating a Dynamic Web Project
- Launch Eclipse. Select File->New->Project.
- Select Web->Dynamic Web Project. Select Next.
- On the next screen give the name of the project as WebEJB.
- Select default values for all other fields. Finally select Finish.
- Right click on WebContent and Select New->JSP.
- Name the jsp as index.jsp. Select Next->Finish.
- Right Click on JavaResources and Select New->Other.
- Select Web->Servlet. Select Next.
- Name the package as webejb and Servlet as ConverterHandler. Select Next->Finish.
Adding code to EJB Project
- Add the following code to the interface Converter.java.
Here the @Remote annotation is used to declare it as a Remote Interface.
- Add the following code to the class ConverterBean.java
Here the @Stateless annotation declares the POJO(Plain Old Java Object) as a Stateless session bean.
This complete the EJB code.
Adding code to Web Project
- Add the following code to index.jsp.
- Add the following code to ConverterHandler servlet.
The @EJB(name = "ejb/Converter") injects the EJB into the servlet. This completes the code for Web project.
Some more configurations
- Modify the deployment plan that is geronimo-web.xml as follows:
We have added a dependencies element (i.e., <dependencies>) and an ejb reference element (i.e., <ejb-ref>) to geronimo-web.xml. This step is required to make our CurrencyConvertEJB visible to our web application.
- Right Click on WebEJB project and select properties. Select Java Build Path->Projects. Click add and add CurrencyConvertEJB. This is required for the compilation of Client code. This is explained with the following screenshots.
Deploy and Run
- Right click on the Geronimo server in the J2EE perspective and select Add and Remove Projects...
- There should be 2 projects in your workspace. Select Add All >> and then select Finish.
- Launch the browser in Eclipse (use the Globe icon at the top of the Eclipse main window) and run the application using http://localhost:8080/WebEJB/. This will give the following page.
- Give the amount as 15 and Select Submit.
- This will convert the Dollar amount to Rupees and Euro.