From b0236555142d2a340dedc6816825f4334bf536ea Mon Sep 17 00:00:00 2001 From: markt Date: Fri, 29 Jul 2011 12:52:26 +0000 Subject: [PATCH] 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. git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1152192 13f79535-47bb-0310-9956-ffa450edef68 --- webapps/docs/changelog.xml | 6 ++++++ webapps/docs/class-loader-howto.xml | 15 +++++++++++---- 2 files changed, 17 insertions(+), 4 deletions(-) diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml index 071b9a20f..93509294e 100644 --- a/webapps/docs/changelog.xml +++ b/webapps/docs/changelog.xml @@ -180,6 +180,12 @@ application to recommend the use of digest.[bat|sh] to generate digests rather than calling RealmBase directly. (markt) + + 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. (markt) + diff --git a/webapps/docs/class-loader-howto.xml b/webapps/docs/class-loader-howto.xml index c7968ef2e..9bfa823ac 100644 --- a/webapps/docs/class-loader-howto.xml +++ b/webapps/docs/class-loader-howto.xml @@ -100,10 +100,17 @@ loaders as it is initialized:

  • Common - This class loader contains additional classes that are made visible to both Tomcat internal classes and to all web applications. Normally, application classes should NOT - be placed here. All unpacked classes and resources in - $CATALINA_HOME/lib, 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 common.loader property in + $CATALINA_BASE/conf/catalina.properties. The default setting will search the + following locations in the order they are listed: +
      +
    • unpacked classes and resources in $CATALINA_BASE/lib
      • +
    • JAR files in $CATALINA_BASE/lib
      • +
    • unpacked classes and resources in $CATALINA_HOME/lib
      • +
    • JAR files in $CATALINA_HOME/lib
      • +
    + By default, this includes the following:
    • annotations-api.jar - JEE annotations classes.
    • catalina.jar - Implementation of the Catalina servlet -- 2.11.0