DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=15115>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=15115

correct docs... XML parser *cannot* be overridden by putting in WEB-INF/lib

           Summary: correct docs... XML parser *cannot* be overridden by
                    putting in WEB-INF/lib
           Product: Tomcat 4
           Version: 4.1.16
          Platform: Other
        OS/Version: Other
            Status: NEW
          Severity: Enhancement
          Priority: Other
         Component: Webapps:Documentation
        AssignedTo: [EMAIL PROTECTED]
        ReportedBy: [EMAIL PROTECTED]


http://jakarta.apache.org/tomcat/tomcat-4.1-doc/class-loader-howto.html

I see a problem with the documentation.  It says:

<quote>
xerces.jar - The XML parser that is visible by default to Tomcat
internal classes and to web applications. This can be overridden, for
a particular web application, by including your desired parser in /WEB-INF/lib.
</quote>

That is very wrong and violates the Sun classloading spec.  Tomcat has
enforced this since 4.0.2, but things were buggy at that time so
Tomcat didn't do a perfect job at ignoring the XML parser.  Instead,
you'd get ClassCastExceptions and such.  I'm
pretty sure Xerces is mostly ignored in Tomcat-4.1.12.  The XML parser
should exist in one of a few places:

1.  In the JDK (true with j2sdk1.4.x)
2.  Overridden in JAVA_HOME/jre/lib/endorsed
3.  Overridden in CATALINA_HOME/common/endorsed
4.  Be placed in CATALINA_HOME/common/lib.  Note that this will not
override existing XML parsers from endorsed directories, but if you
are using JDK1.3.x, then it will be used since that JDK version
doesn't include an XML parser.  The Xerces classes will be
loaded either way...unless the full Xerces is in an endorsed directory
already.

See the following bug reports and comments by Remy and others about why it is
true that the XML parser (and DOM libraries) should *not* be in WEB-INF/lib....

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=6248
http://nagoya.apache.org/bugzilla/show_bug.cgi?id=6476
http://nagoya.apache.org/bugzilla/show_bug.cgi?id=6374
http://nagoya.apache.org/bugzilla/show_bug.cgi?id=7175

Jake

--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to