Java SpringMVC 集成静态资源的方式你了解吗

时间:2022-06-06 19:17:19

1、本文内容

  • 静态资源 & jsp 是被谁处理的?
  • 如何让 springmvc 处理所有请求?
  • springmvc 如何处理静态资源?
  • springmvc 处理静态资源的 2 种方案、区别、原理详解

 

2、静态资源 & jsp 是被谁处理的?

不知大家是否注意了一个问题,我们将 web 项目发布到 tomcat 后,可以直接访问 jsp 后缀的文件,或者直接访问项目中的静态资源(js/css/图片之类的文件),只要路径写的没有问题,都可以正常在浏览器中显示,大家是否思考过,是谁在处理这个请求呢?

tomcat 是一个 servlet 容器,servlet 容器中通常有 servlet 来处理各种请求,那么当我们访问静态资源或者 jsp 的时候,当然也是由 servlet 来处理这些请求的,但是我们并没有在 web.xml 中配置由哪个 servlet 来处理这些请求啊,这是因为 tomcat 中自动帮我们配置了一些默认的 servlet 来处理这类的请求。

tomcat 的安装目录中有个 web.xml 文件,位于(apache-tomcat-9.0.46\conf\web.xml),这个文件相当于对发布到 tomcat 中的所有 web 项目的默认配置,我们来看一下这个文件,有几个重要的 servlet 配置信息,这些 servlet 可以用来处理 jsp 后置的文件或者静态资源,抽取部分配置如下

<servlet>
<servlet-name>defaultservlet-name>
<servlet-class>org.apache.catalina.servlets.DefaultServletservlet-class>
<load-on-startup>1load-on-startup>
servlet>
<servlet>
<servlet-name>jspservlet-name>
<servlet-class>org.apache.jasper.servlet.JspServletservlet-class>
<load-on-startup>3load-on-startup>
servlet>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>/url-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>jspservlet-name>
<url-pattern>*.jspurl-pattern>
<url-pattern>*.jspxurl-pattern>
servlet-mapping>

配置中主要定义了 2 个 servlet

JspServlet 用来处理 jsp 文件

DefaultServlet 会处理/开头的请求,这里重点说下这个 servlet 的处理逻辑,它会处理所有其他 servlet 不匹配的请求,当一个请求过来之后,会先去匹配其他的 servlet,当找不到匹配的 servlet 的时候,才会走 DefaultServlet

我们可以在项目中的 web.xml 中对 tomcat/config/web.xml 中的配置进行覆盖,即项目中的 web.xml 相对于 tomcat 中的 web.xml 有更高的优先级。

 

3、如何让 springmvc 处理所有请求?

如果我们想让 springmvc 来处理所有的请求,怎么做呢?只需修改 web.xml 中的配置,将 springmvc 这个 servlet 的 url-pattern 的值设置为/就可以了,此时所有的请求都会被 springmvc 处理,即所有的请求都会被DispatcherServlet处理。

Java SpringMVC 集成静态资源的方式你了解吗

 

4、问题来了:静态资源 404 了

当我们将上面 springmvc 的 url-pattern 改为/时,大家可以自己去试试,此时再访问静态资源的时候,如下图,会报 404,这个请求被 DispatcherServlet 接收了,但是这个 servlet 默认情况下并没有处理静态资源的能力,即找不到请求的资源,所以才会报 404

Java SpringMVC 集成静态资源的方式你了解吗

springmvc 提供了 2 种解决方案,来看下。

 

5、方案 1:使用

在 springmvc 的配置文件中添加下面配置

<mvc:annotation-driven/>
<mvc:default-servlet-handler/>

这里说一下原理

1、加入配置后,框架会创建DefaultServletHttpRequestHandler对象,这个对象会将请转发给 tomcat 的 default 这个 servlet 处理,所以静态资源就可以正常访问了

2、注意:配置中的第 1 行也必须加上,如果不加上,@RequestMapping 的请求就无法处理了

3、这种用法有个前提是,web 容器中需要有 default 这个 servlet,且这个 servlet 可以处理静态资源

 

6、方案 2:使用

从 spring3.0 版本后,spring 定义了专门处理静态资源访问请求的处理器ResourceHttpRequestHandler,并且添加了标签,用来处理静态资源无法访问的问题。

需要在 springmvc 配置文件中添加如下配置

<mvc:annotation-driven/>
<mvc:resources mapping="/imgs/**" location="/static/imgs/"/>
<mvc:resources mapping="/css/**" location="/static/css/"/>
<mvc:resources mapping="/js/**" location="/static/js/"/>

mvc:resource 标签用来指定请求的静态资源的 url 和本地地址的映射关系

mapping:用来指定请求的地址的,比如/imgs/**:可以匹配任何以 imgs 开头的 url,如:/imgs/1.jpg、/imgs/2.jpg、/imgs/order/3.jpg

location:用来指定静态资源所在项目中的目录

注意:配置中的第 1 行也必须加上,如果不加上,@RequestMapping 的请求就无法处理了

这种用法不依赖于 web 容器,所以比第一种方案要好一些,也建议大家用这种方案。

上面代码中配置了 3 行 mvc:resources,可以优化下,如下

<mvc:resources mapping="/static/**" location="/static/"/>
</mvc:resources mapping=

 

7、总结

tomcat 默认能够处理 jsp 和静态资源,是因为 tomcat 中默认有 2 个 servlet:default 和 jsp

到此我们已经知道如何让 springmvc 来处理所有请求了,只需要在 web.xml 中调整一下 url-pattern 的值为/就可以了

默认情况下,springmvc 无法处理静态资源,本文介绍了 2 种方式,大家可以回头在再去看看,第一种需要依赖于 web 容器中的 default 这个 servlet,使用上面对 web 容器有依赖作用;而第 2 种方式是 springmvc 推荐的方式,更好一些,对 web 容器没有依赖

不管用那种方式,都不要忘记了这个注解,否则咱们自定义的 controller 中的@RequestMapping 就无效了

本篇文章就到这里了,希望能够给你带来帮助,也希望您能够多多关注服务器之家的更多内容!

原文链接:https://blog.csdn.net/likun557/article/details/119582956