Before you start
This tutorial is for EJB developers who want to leverage the power of declarative persistence using Geronimo Beans and EJB QL.
This tutorial gets you up to speed using the EJB QL on the Apache Geronimo application server. To illustrate how to do this, you'll develop a simple yellow pages application that has entities with one-to-one, one-to-many, and many-to-many types of relationships. You'll set up the entity relationships in the EJB layer and use the EJB QL to query your entity model. In this tutorial you'll also implement finder methods, a key feature of the EJB QL, that retrieve entity bean instances through the database. Plus you'll learn basic Struts programming for the user interface (UI).
You should have a high degree of familiarity with JavaServer Pages (JSP) and EJB.
The following applications and tools are specifically used to run the code samples in this tutorial:
- Apache Geronimo application server -- Download the Geronimo 1.1 binary distribution, (either the Tomcat or Jetty version will work). Extract the Geronimo 1.1 server binary release into the directory of your choice.
- Database -- This tutorial uses Apache Derby, which is open source and lightweight and is embedded with Geronimo, so no separate download is required.
- Java platform -- Download Java 2 Platform, Standard Edition (J2SE) 1.5 from Sun Microsystems.

