[jboss-user] [JBoss Cache] Document updated/added: "JBossCacheHabaneroJava1.4"
User development,
The document "JBossCacheHabaneroJava1.4", was updated Feb 22, 2010
by Manik Surtani.
To view the document, visit:
http://community.jboss.org/docs/DOC-10263#cf
Document:
--------------------------------------------------------------
h2. Running JBoss Cache 2.x under Java 1.4.x
This page details how to run JBoss Cache +Habanero+ series (2.0.0 series) under Java 1.4.
+Habanero+ is baselined on Java 5 and makes heavy use of Java 5 features, both language
and API. However, using JBossRetro, we are able to provide retroweaved binaries that does
run under Java 1.4.
It is important to note that, at least as of this writing, there is no commercial support
for retroweaved binaries offered by Red Hat Inc.
h3. What you will need
h4. Habanero source tree
The source tree of JBoss Cache +Habanero+ from CVS - see JBossCacheDevelopment for details
of how to get this.
h4. A compatible version of JGroups.
While +Habanero+ ships with JGroups 2.5, JGroups 2.5 is also baselined on Java 5. This
means that the retroweaved binary of JBoss Cache will need to link against a version of
JGroups that is both compatible with JBoss Cache as well as Java 1.4. Here, you have 2
options:
* An older version of JGroups.
+Habanero+ does not make any specific use of JGroups 2.5 APIs. This means that +Habanero+
should run just as happily with JGroups >= 2.3. However, it is important to note that
some protocols in the JGroups stack may not be present in older JGroups versions. Visit
http://www.jgroups.org for more details.
* Retroweave JGroups as well.
This is a fairly simple process. You will need to download the JGroups 2.5 source
distribution, and retroweave the resulting binaries yourself. Please refer to the
examples and (brief) documentation on the JBossRetro page.
Whichever route you choose, make sure you replace the jgroups.jar file in the lib
directory of the JBoss Cache source tree with the version of JGroups you wish to use.
h3. Retroweaving JBoss Cache
This is a fairly straightforward process as well, especially since the build file that is
in the JBoss Cache source tree contains an ANT target to do this for you. Note that this
target *must* be run with *Java 5*!
./build.sh clean jar-retro
This will create a jar file called jbosscache-JDK140.jar in the dist/lib directory.
h3. Test your build
Ensuring that your *JAVA_HOME* now points to a Java 1.4.x JVM, run:
./build.sh all-unittests-retro-cc reports
HTML-ised reports will be in output/reports/html/
h3. Using the retroweaved binary
Just like the standard distribution of JBoss Cache, the retroweaved version has runtime
dependencies on the jars in the lib directory. In addition though, it also has runtime
dependencies on the jars in lib/retro so make sure these are made available to your
application.
h2. What about PojoCache?
Note that PojoCache does not get retroweaved. There is no plan at this stage to provide a
retroweaved binary for PojoCache.
--------------------------------------------------------------