You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by hl...@apache.org on 2007/02/21 19:01:39 UTC
svn commit: r510124 - in /tapestry/tapestry5/tapestry-project/trunk: pom.xml
src/site/apt/jboss.apt src/site/apt/jetty.apt src/site/apt/tomcat.apt
src/site/resources/t5-tutorial.pdf src/site/site.xml
src/t5-tutorial.pages.tar.bz2
Author: hlship
Date: Wed Feb 21 10:01:38 2007
New Revision: 510124
URL: http://svn.apache.org/viewvc?view=rev&rev=510124
Log:
Add deployment notes about the main servlet containers.
[TAPESTRY-1287]
Added:
tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jboss.apt
tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jetty.apt
tapestry/tapestry5/tapestry-project/trunk/src/site/apt/tomcat.apt
Modified:
tapestry/tapestry5/tapestry-project/trunk/pom.xml
tapestry/tapestry5/tapestry-project/trunk/src/site/resources/t5-tutorial.pdf
tapestry/tapestry5/tapestry-project/trunk/src/site/site.xml
tapestry/tapestry5/tapestry-project/trunk/src/t5-tutorial.pages.tar.bz2
Modified: tapestry/tapestry5/tapestry-project/trunk/pom.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/tapestry-project/trunk/pom.xml?view=diff&rev=510124&r1=510123&r2=510124
==============================================================================
--- tapestry/tapestry5/tapestry-project/trunk/pom.xml (original)
+++ tapestry/tapestry5/tapestry-project/trunk/pom.xml Wed Feb 21 10:01:38 2007
@@ -313,7 +313,6 @@
<properties>
<!-- Version 2.1-SNAPSHOT lists everything as 100% covered, wierd. -->
<cobertura-plugin-version>2.0</cobertura-plugin-version>
- <component-report-version>5.0.2-SNAPSHOT</component-report-version>
</properties>
</project>
Added: tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jboss.apt
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jboss.apt?view=auto&rev=510124
==============================================================================
--- tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jboss.apt (added)
+++ tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jboss.apt Wed Feb 21 10:01:38 2007
@@ -0,0 +1,29 @@
+ ----
+ Deployment Notes: JBoss
+ ----
+
+Deployment Notes: JBoss
+
+ JBoss's default servlet container is {{{tomcat.html}Tomcat}}, so deployment notes for Tomcat apply to JBoss as well.
+
+ JBoss has a very odd class loader structure that causes havoc with many frameworks, including Tapestry 5. The way to get around it is to edit the configuration file
+ <JBoss root>/server/default/deploy/jbossweb-tomcat55.sar/META-INF/jboss-service.xml and turn on the UseJBossWebLoader attribute:
+
++----+
+ <!-- A flag indicating if the JBoss Loader should be used. This loader
+ uses a unified class loader as the class loader rather than the tomcat
+ specific class loader.
+ The default is false to ensure that wars have isolated class loading
+ for duplicate jars and jsp files.
+ -->
+ <attribute name="UseJBossWebLoader">true</attribute>
++----+
+
+ This is not a very good solution, as it affects all web applications within the server, potentially causing other problems. Hopefully a better solution will
+ be discoverred in the future. And perhaps a time traveller will venture back in time with that information and save me a lot of headaches yesterday.
+
+ Tapestry has been tested with JBoss 4.0.5, which uses Tomcat 5.5.20.
+
+* Logging
+
+ TODO: Discuss logging configuration for JBoss.
\ No newline at end of file
Added: tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jetty.apt
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jetty.apt?view=auto&rev=510124
==============================================================================
--- tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jetty.apt (added)
+++ tapestry/tapestry5/tapestry-project/trunk/src/site/apt/jetty.apt Wed Feb 21 10:01:38 2007
@@ -0,0 +1,17 @@
+ ----
+ Deployment Notes: Jetty
+ ----
+
+Deployment Notes: Jetty
+
+ {{{http://jetty.mortbay.com}Jetty}} is the easiest servlet container to deploy Tapestry into, it just plain works.
+
+ The easiest way to develop Tapestry applications is to run Jetty <embedded> inside your IDE. If you use Eclipse,
+ then {{{http://jettylauncher.sourceforge.net/}the Jetty Launcher plugin}} is invaluable. The
+ {{{t5-tutorial.pdf}Tapestry 5 Tutorial}} [PDF] discusses installing and using Jetty Launcher.
+
+ Jetty Launcher only works with Jetty <<4 or 5>> and <<not>> Jetty 6.
+
+* Logging
+
+ TODO: Discuss logging configuration for Jetty.
\ No newline at end of file
Added: tapestry/tapestry5/tapestry-project/trunk/src/site/apt/tomcat.apt
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/tapestry-project/trunk/src/site/apt/tomcat.apt?view=auto&rev=510124
==============================================================================
--- tapestry/tapestry5/tapestry-project/trunk/src/site/apt/tomcat.apt (added)
+++ tapestry/tapestry5/tapestry-project/trunk/src/site/apt/tomcat.apt Wed Feb 21 10:01:38 2007
@@ -0,0 +1,31 @@
+ ----
+ Deployment Notes: Tomcat
+ ----
+
+Deployment Notes: Tomcat
+
+ Deploying Tapestry applications into {{{http://tomcat.apache.org/}Tomcat}} is relatively easy, with one big caveat: you must not store your Tapestry component classes under WEB-INF/classes.
+
+ At startup, Tapestry needs to locate all your page and component classes, so that it can match page names in request URLs to page classes. Due to the way
+ Tomcat creates ClassLoaders, this information is not accessible to Tapestry.
+
+ Fortunately, Maven has an option inside its war plugin,
+ {{{http://maven.apache.org/plugins/maven-war-plugin/war-mojo.html#archiveClasses}archiveClasses}}, that changes the packaging; instead of putting compiled
+ classes and resource files in
+ WEB-INF/classes, they are instead placed inside an additional JAR inside WEB-INF/lib. This keeps Tapestry happy at runtime.
+
+ The {{{http://tapestry.apache.org/tapestry5/tapestry-simple}tapestry-simple archetype}} configures your project's Maven pom.xml file to make use of this
+ option.
+
+ Tapestry 5 has been tested with Tomcat 5.5.20.
+
+* index.html
+
+ If your application has an index.html file, Tomcat appears to use that file, rather than triggering the Tapestry filter to render the application Start page
+ for a base URL (just the context path).
+
+ By contrast, {{{jetty.html}Jetty}} favors the filter over the index.html file.
+
+* Logging
+
+ TODO: Discuss logging configuration for Tomcat.
\ No newline at end of file
Modified: tapestry/tapestry5/tapestry-project/trunk/src/site/resources/t5-tutorial.pdf
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/tapestry-project/trunk/src/site/resources/t5-tutorial.pdf?view=diff&rev=510124&r1=510123&r2=510124
==============================================================================
Binary files - no diff available.
Modified: tapestry/tapestry5/tapestry-project/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/tapestry-project/trunk/src/site/site.xml?view=diff&rev=510124&r1=510123&r2=510124
==============================================================================
--- tapestry/tapestry5/tapestry-project/trunk/src/site/site.xml (original)
+++ tapestry/tapestry5/tapestry-project/trunk/src/site/site.xml Wed Feb 21 10:01:38 2007
@@ -40,6 +40,12 @@
<item name="tapestry-simple" href="tapestry-simple/"/>
<item name="tapestry-component-report" href="tapestry-component-report/"/>
</menu>
+
+ <menu name="Deployment Notes">
+ <item name="Jetty" href="jetty.html"/>
+ <item name="Tomcat" href="tomcat.html"/>
+ <item name="JBoss" href="jboss.html"/>
+ </menu>
<menu name="Developer Info">
<item name="DevWiki" href="tap5devwiki.html"/>
Modified: tapestry/tapestry5/tapestry-project/trunk/src/t5-tutorial.pages.tar.bz2
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/tapestry-project/trunk/src/t5-tutorial.pages.tar.bz2?view=diff&rev=510124&r1=510123&r2=510124
==============================================================================
Binary files - no diff available.