root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 2 Packages Projects Releases Wiki Activity

SPR-7116 - Added documentation for <mvc:default-servlet-handler>

This commit is contained in:
Jeremy Grelle 2010-08-03 16:14:37 +00:00
parent 6adf8d18df
commit 103297cf59
1 changed files with 24 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
spring-framework-reference/src/mvc.xml
View File

@ -3414,7 +3414,30 @@ application.version=1.0.0]]>
<spring:param name="applicationVersion" value="${applicationVersion}"/>
</spring:url>
<script src="${resourceUrl}/dojo/dojo.js" type="text/javascript" > </script>]]>
<script src="${resourceUrl}/dojo/dojo.js" type="text/javascript"> </script>]]>
</programlisting>
</section>
<section id="mvc-default-servlet-handler">
<title>mvc:default-servlet-handler</title>
<para>
This tag allows for mapping the <code>DispatcherServlet</code> to "/" (thus overriding the mapping of the container's default Servlet),
while still allowing static resource requests to be handled by the container's default Servlet. It configures a
<code>DefaultServletHttpHandler</code> with a URL mapping (given a lowest precedence order) of "/**". This handler will
forward all requests to the default Servlet. To enable this feature using the default setup, simply include the tag in the form:
</para>
<programlisting language="xml"><![CDATA[
<mvc:default-servlet-handler/>]]>
</programlisting>
<para>
The caveat to overriding the "/" Servlet mapping is that the <code>RequestDispatcher</code> for the default Servlet must be
retrieved by name rather than by path. The <code>DefaultServletHttpHandler</code> will attempt to auto-detect the default
Servlet for the container at startup time, using a list of known names for most of the major Servlet containers (including Tomcat,
Jetty, Glassfish, JBoss, Resin, WebLogic, and WebSphere). If the default Servlet has been custom configured
with a different name, or if a different Servlet container is being used where the default Servlet name is unknown, then the
default Servlet's name must be explicitly provided as in the following example:
</para>
<programlisting language="xml"><![CDATA[
<mvc:default-servlet-handler default-servlet-name="myCustomDefaultServlet"/>]]>
</programlisting>
</section>
</section>