You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2011/07/29 14:52:26 UTC

svn commit: r1152192 - in /tomcat/trunk/webapps/docs: changelog.xml class-loader-howto.xml

Author: markt
Date: Fri Jul 29 12:52:26 2011
New Revision: 1152192

URL: http://svn.apache.org/viewvc?rev=1152192&view=rev
Log:
Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=51567
Update the class loading page of the documentation web application to include information on the search order for the common class loader when separate values are used for $CATALINA_HOME and $CATALINA_BASE.

Modified:
    tomcat/trunk/webapps/docs/changelog.xml
    tomcat/trunk/webapps/docs/class-loader-howto.xml

Modified: tomcat/trunk/webapps/docs/changelog.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/changelog.xml?rev=1152192&r1=1152191&r2=1152192&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/changelog.xml (original)
+++ tomcat/trunk/webapps/docs/changelog.xml Fri Jul 29 12:52:26 2011
@@ -180,6 +180,12 @@
         application to recommend the use of digest.[bat|sh] to generate digests
         rather than calling RealmBase directly. (markt) 
       </fix>
+      <fix>
+        <bug>51567</bug>: Update the class loading page of the documentation
+        web application to include information on the search order for the
+        common class loader when separate values are used for $CATALINA_HOME and
+        $CATALINA_BASE. (markt) 
+      </fix>
     </changelog>
   </subsection>
   <subsection name="Other">

Modified: tomcat/trunk/webapps/docs/class-loader-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/class-loader-howto.xml?rev=1152192&r1=1152191&r2=1152192&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/class-loader-howto.xml (original)
+++ tomcat/trunk/webapps/docs/class-loader-howto.xml Fri Jul 29 12:52:26 2011
@@ -100,10 +100,17 @@ loaders as it is initialized:</p>
 <li><strong>Common</strong> - This class loader contains additional classes
     that are made visible to both Tomcat internal classes and to all web
     applications.  Normally, application classes should <strong>NOT</strong>
-    be placed here.  All unpacked classes and resources in
-    <code>$CATALINA_HOME/lib</code>, as well as classes and
-    resources in JAR files are made visible through this
-    class loader.  By default, that includes the following:
+    be placed here.  The locations searched by this class loader are defined by
+    the <code>common.loader</code> property in
+    $CATALINA_BASE/conf/catalina.properties. The default setting will search the
+    following locations in the order they are listed:
+    <ul>
+      <li>unpacked classes and resources in <code>$CATALINA_BASE/lib</code></li>
+      <li>JAR files in <code>$CATALINA_BASE/lib</code></li>
+      <li>unpacked classes and resources in <code>$CATALINA_HOME/lib</code></li>
+      <li>JAR files in <code>$CATALINA_HOME/lib</code></li>
+    </ul>
+    By default, this includes the following:
     <ul>
     <li><em>annotations-api.jar</em> - JEE annotations classes.</li>
     <li><em>catalina.jar</em> - Implementation of the Catalina servlet



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org