The jee5/booking example is based on the Hotel Booking example (which runs on JBoss AS). Out of the box it is designed to run on Glassfish, but it's easy to build it for OC4J.

This mini-tutorial describes the (fairly tedious) steps required to deploy a JEE 5 application to OC4J. It assumes you are deploying the jee5/booking example, using the embedded hsqldb database. To deploy another application you would need to alter the datasource and application name.

The following explanation assumes you are using the command line and a simple text editor, but of course you can use your favourite IDE - seam-gen projects come with support for Eclipse and Netbeans.

We start by creating a pretty simple application using seam-gen. seam-gen uses Hibernate Tools to reverse engineer a database schema to JPA entity beans; it also genereates Seam Application Framework components and JSF views for CRUD. This tutorial uses MySQL (but of course you could use any database, altering the SQL as appropriate); install, configure and run MySQL, then create a database with some sample data.

Next, run ./seam setup in the seam directory.

> ./seam setup
Buildfile: build.xml

setup:
    [echo] Welcome to seam-gen :-)
    [input] Enter your Java project workspace (the directory that contains your Seam projects) [/home/pmuir/workspace] [/home/pmuir/workspace]

    [input] Enter your JBoss home directory [/home/pmuir/java/jboss-4.2.1.GA] [/home/pmuir/java/jboss-4.2.1.GA]

    [input] Enter the project name [oc4j-example] [oc4j-example]

    [input] Is this project deployed as an EAR (with EJB components) or a WAR (with no EJB support) [ear]  ([ear], war, )

    [input] Enter the Java package name for your session beans [org.jboss.seam.tutorial.oc4j.action] [org.jboss.seam.tutorial.oc4j.action]

    [input] Enter the Java package name for your entity beans [org.jboss.seam.tutorial.oc4j.model] [org.jboss.seam.tutorial.oc4j.model]

    [input] Enter the Java package name for your test cases [org.jboss.seam.tutorial.oc4j.test] [org.jboss.seam.tutorial.oc4j.test]

    [input] What kind of database are you using? [mysql]  (hsql, [mysql], oracle, postgres, mssql, db2, sybase, enterprisedb, )

    [input] Enter the Hibernate dialect for your database [org.hibernate.dialect.MySQLDialect] [org.hibernate.dialect.MySQLDialect]

    [input] Enter the filesystem path to the JDBC driver jar [lib/mysql.jar] [lib/mysql.jar]

    [input] Enter JDBC driver class for your database [com.mysql.jdbc.Driver] [com.mysql.jdbc.Driver]

    [input] Enter the JDBC URL for your database [jdbc:mysql:///oc4j] [jdbc:mysql:///oc4j]

    [input] Enter database username [user] [user]

    [input] Enter database password [password] [password]

    [input] skipping input as property hibernate.default_schema.new has already been set.
    [input] Enter the database catalog name (it is OK to leave this blank) [] []

    [input] Are you working with tables that already exist in the database? [y]  ([y], n, )

    [input] Do you want to drop and recreate the database tables and data in import.sql each time you deploy? [n]  (y, [n], )

    [propertyfile] Updating property file: /home/pmuir/workspace/jboss-seam/seam-gen/build.properties
    [echo] Installing JDBC driver jar to JBoss server
    [echo] Type 'seam new-project' to create the new project

BUILD SUCCESSFUL

Type ./seam new-project to create your project and cd to the newly created project.

Type ./seam generate-entities to run create the entities, the Seam Application Framework classes and the relevant views.

We now need to make some changes to the generated project. Let's start with the configuration files:

Now, lets add in the extra dependencies:

You should end up with something like:

<fileset dir="${basedir}">
   <!-- other libraries added by seam-gen -->
   <include name="lib/hibernate-annotations.jar" />
   <include name="lib/hibernate-entitymanager.jar" />
   <include name="lib/hibernate3.jar" />
   <include name="lib/jboss-archive-browsing.jar" />
   <include name="lib/jboss-common.jar" />
   <include name="lib/thirdparty-all.jar" />
   <include name="lib/antlr-*.jar" />
   <include name="lib/org.eclipse.jdt.core*.jar" />
</fileset>

Finally, lets link our User entity into Seam Security (we have a User table with a username column and a password column). We're going to make our authentictor a Stateless Session Bean (OC4J is a EJB3 container after all!):

Now you can go on and customize your application.