welcome-file-list 与SpringMvc 的 DispatcherServlet

1. <welcome-file-list>标签下可以设置多个首页<welcome-file>，容器启动后会在根目录下依次查找匹配的物理存在的文件，返回第一个找到的文件，没有找到报404错误。敲黑板了，敲黑板了，敲黑板了，注意首页的路径只能是一个实际存在的物理文件地址，不能将首页设置成Servlet或Controller的地址，再通过来Servlet或Controller返回一个页面，否则404

<welcome-file-list>		
		<welcome-file>test.html</welcome-file>
		<welcome-file>index.html</welcome-file>
		<welcome-file>index.jsp</welcome-file>
		<welcome-file>default.html</welcome-file>
		<welcome-file>default.htm</welcome-file>
		<welcome-file>default.jsp</welcome-file>
	</welcome-file-list>

2.如果确实需要使用控制器来返回页面，可以投机取巧，可以在欢迎页页面中跳转到控制器路径来实现。建立首页文件index.html，内容如下，URL为跳转路径，再将该页面设置为主页。

<html> 
<head>
  <meta http-equiv="Refresh" content="0; URL=/login">
</head>
</html>

或者不设置欢迎页直接使用根路径"/"来映射

@RequestMapping("/")
public String indexPage() throws Exception {
	return "index"; 
	}

springMVC.xml中配置试图解析器

<!-- 配置视图解析器 -->
	<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<property name="prefix" value="/WEB-INF/jsp/"/>
		<property name="suffix" value=".jsp"/>
	</bean>

url-pattern匹配规则的三种写法

1. 精确匹配。形如/add。

注：/user/*/index也是精确匹配，其中的*不是通配符而是字符*。只有/user/*/index才能匹配上，/user/a/index，/user/b/index都是无法匹配的。

2. 路径匹配。形如/*，/user/*，以以/开头，/*结尾

3. 扩展名匹配。形如*.do

注以上三种匹配不能组合混用。

4. 默认匹配/，当以上都无法匹配时，就是用默认的Servlert。优先级最低

匹配优先级

精确匹配>路径匹配(长路径优先级大于短路径优先级)>扩展名匹配>缺省匹配

"/*"与"/"

“/*”属于路径匹配，并且可以匹配所有request，由于路径匹配的优先级仅次于精确匹配，所以“/*”会覆盖所有的扩展名匹配，很多404错误均由此引起，一般只用于filter的url-pattern。
“/”默认匹配模式，优先级最低，不会覆盖其他任何url-pattern，只是会替换servlet容器的内建default servlet ，该模式同样会匹配所有request（除了jsp文件）。
配置“/”后，会拦截诸如http://localhost:8080/appDemo/user/addUser.action、http://localhost:8080/appDemo/user/updateUser的格式的请求，但是并不会拦截http://localhost:8080/appDemo/user/users.jsp、http://localhost:8080/appDemo/index.jsp，这是因为servlet容器有内置的“*.jsp”匹配器，而扩展名匹配的优先级高于缺省匹配，所以才会有上述现象。

/*与/都会拦截.css，.js，.html等静态资源。

默认的servlet 配置是在tomcat目录下的conf/web.xml 中，如下图

配置“/”后静态资源的处理

在SpringMVC框架中我们会配置请求默认由DispatcherServlet来处理，这样静态资源的处理也会被拦截到由DispatcherServlet处理，而我们并没与写Controller来进行映射，常报404。

3种方式解决方法

1. 使用web服务器默认的servlet来做处理，它会根据请求路径正确找到资源，tomcat默认servlet名称为default

<servlet-mapping>

<servlet-name>default</servlet-name>

<url-pattern>*.jpg</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>default</servlet-name>

<url-pattern>*.js</url-pattern>

</servlet-mapping>

<servlet-mapping>

<servlet-name>default</servlet-name>

<url-pattern>*.css</url-pattern>

</servlet-mapping>

要写多个，要配置多个，每种文件配置一个

2、使用<mvc:default-servlet-handler/>

配置<mvc:default-servlet-handler/>后，会把"/**" url注册到SimpleUrlHandlerMapping的urlMap中,请求到达DisPatcherServlet 后，把对静态资源的访问通过HandlerMapping转到DefaultServletHttpRequestHandler处理并返回。DefaultServletHttpRequestHandler使用就是各个Servlet容器自己的默认Servlet。一般Web应用服务器默认的Servlet名称是"default"，因此DefaultServletHttpRequestHandler可以找到它。如果你所有的Web应用服务器的默认Servlet名称不是"default"，则需要通过default-servlet-name属性显示指定：<mvc:default-servlet-handler default-servlet-name="所使用的Web服务器默认使用的Servlet名称" />

3. 使用<mvc:resources mapping="" location="" />

<mvc:default-servlet-handler />将静态资源的处理经由Spring MVC框架交回Web应用服务器处理。而<mvc:resources />更进一步，由Spring MVC框架自己处理静态资源，并添加一些有用的附加值功能。

使用<mvc:resources/>元素,同样会把mapping的URI注册到SimpleUrlHandlerMapping的urlMap中,key为mapping的URI pattern值,而value为ResourceHttpRequestHandler,这样就巧妙的把对静态资源的访问由HandlerMapping转到ResourceHttpRequestHandler处理并返回。<mvc:resources />允许静态资源放在任何地方，如WEB-INF目录下、类路径下等，甚至可以将JavaScript等静态文件打到JAR包中。通过location属性指定静态资源的位置，由于location属性是Resources类型，因此可以使用诸如"classpath:"等的资源前缀指定资源位置。传统Web容器的静态资源只能放在Web容器的根路径下，<mvc:resources />完全打破了这个限制。

补充说明：多个HandlerMapping的执行顺序问题

DefaultAnnotationHandlerMapping的order属性值是：0
<mvc:resources/>自动注册的 SimpleUrlHandlerMapping的order属性值是：2147483646
<mvc:default-servlet-handler/>自动注册的SimpleUrlHandlerMapping的order属性值是： 2147483647

Spring会先执行order值比较小的。当访问一个a.jpg图片文件时，先通过DefaultAnnotationHandlerMapping来找处理器，一定是找不到的，我们没有叫a.jpg的Action。再按order值升序找，由于最后一个SimpleUrlHandlerMapping是匹配"/**"的，所以一定会匹配上，再响应图片。

在SpringMVC中所有的请求都由dispatcherServlet处理（url-pattern配置的是/），当配置文件中有对静态资源的处理 <mvc:default-servlet-handler/> 时候，先匹配 welcome-file-list 中的文件，依次查找，找到了就返回，如果没有找到就继续匹配到controller

例如附件例子，webapp下有test.html 和index.html两个文件，访问仅仅输入工程名称，首先会返回test.html .如果此文件不存在则返回index.html，如果都不存在则进入controller

附件测试代码:https://download.csdn.net/download/yk614294861/10746638

参考链接：https://blog.csdn.net/xybz1993/article/details/81023955

welcome-file-list 与SpringMvc 的 DispatcherServlet

猜你喜欢