...
anchortop
booking
sample application on Apache Geronimo 2.1.1. You can read about JBoss Seam at its web site....
This document applied to JBoss Seam 2.0.0.GA. Download it from http://sourceforge.net/project/showfiles.php?group_id=22866&package_id=163777&release_id=551158
...
.
...
...
This document now applies to the Geronimo 2.1.1 release.
Also, it is in the process of being updated - the instructions may only be partially corrected.
At this point the instruction have been updated up until the point before the new Hibernate transaction manager jar is installed in the Geronimo repository.
The remaining instructions should work, but they have not been tested yet.
...
Hibernate doesn't support Geronimo by default as far as Geronimo transaction manager's concerned. Whenever Hibernate does transaction management it needs a JTA transaction manager which is a necessary component of every Java EE application server. Geronimo provides one, but Hibernate doesn't know how to look it up. We need to learn the nifty things about the transaction manager in Geronimo and provide a lookup class for Hibernate to access Geronimo transaction manager. With the class - org.apache.geronimo.hibernate.transaction.GeronimoTransactionManagerLookup - Hibernate will be able to do its duties.
...
...
You can read more about migrating JBoss/Hibernate applications to Geronimo at The documentation about JBoss to Geronimo - Hibernate Migration.
...
geronimo-hibernate-transaction-manager-lookup maven project
...
Go to any directory you want where the maven project for Hibernate Transaction Manager Lookup class for Geronimo is to be created.
...
Notice that there are a couple of inputs that you must make:
1) When Maven asks you to select an archetype type - choose quickstart, enter: 15
2) When Maven asks you for a value of the version, enter: 1.0-SNAPSHOT
3) When Maven asks you for the package, enter: org.apache.geronimo.hibernate
Replace the content of pom.xml
which is the main configuration file of any maven project to the following:
...
Change your working directory to the project's directory, e.g. c:/geronimo-hibernate-transaction-manager-lookup
and do the following steps from within it.
...
Create the org.apache.geronimo.hibernate.transaction.GeronimoTransactionManagerLookup
class in src/main/java/org/apache/geronimo/hibernate/transaction/
directory.
...
Build GeronimoTransactionManagerLookup class with mvn install
command.
...
...
Install the file - geronimo-hibernate-transaction-manager-lookup-1.0-SNAPSHOT.jar
- to Geronimo artifact repository, i.e. ${GERONIMO_HOME}/repository
.
With Geronimo stopped, create a directory and place geronimo-hibernate-transaction-manager-lookup-1.0-SNAPSHOT.jar
in it.
...
...
Hibernate JPA change
...
As of GERONIMO-3880 PersistenceUnitInfo.getJarFileUrls() can return null, i.e. Geronimo 2.2-SNAPSHOT built after 02/27 you should not run into this issue and hence no need to execute the steps described in this section.
...
If you tried to deploy JBoss Seam's booking application with Hibernate JPA as it is now it would choke with NPE.
...
Without delving into much detail it boils down to patching org.hibernate.ejb.Ejb3Configuration
to avoid NPE. Download the class from its source code repository at http://fisheye.jboss.com/browse/Hibernate/entitymanager/trunk/src/java/org/hibernate/ejb/Ejb3Configuration.java and patch it with the following changes:
...
With the class patched, compile it with the same command as you build the booking example - ant clean archive
and update hibernate-entitymanager.jar
that's available in {${JBOSSSEAM_HOME}/lib}.
...
After the change you'll have to rebuild the booking example once more.
...
...
The plan Anchor planplan
The plan configures necessary Geronimo resources to deploy JBoss Seam's booking sample application.
...
...
Starting Geronimo
Type it in on the command line.
...
Deploying jboss-seam-jee5.ear
You can now deploy jboss-seam-jee5.ear
from the web console of Geronimo, but there's another way to do the same - executing deploy
command on the command line.
...
...
The Geronimo console shows deployment progress as follows:
...
...
Running the webapp
Point the browser of your choice to http://localhost:8080/seam-jee5/. You should see booking's welcome page.
...