前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >你未必会,SpringMVC 集成静态资源的多种方式 | SpringMVC第11篇

你未必会,SpringMVC 集成静态资源的多种方式 | SpringMVC第11篇

作者头像
路人甲Java
发布2021-08-20 17:23:16
4880
发布2021-08-20 17:23:16
举报
文章被收录于专栏:路人甲Java路人甲Java

文末可领取最近刚整理的,后端必备的 200 本书籍。

1、本文内容

  • 静态资源 & jsp 是被谁处理的?
  • 如何让 springmvc 处理所有请求?
  • springmvc 如何处理静态资源?
  • springmvc 处理静态资源的 2 种方案、区别、原理详解
  • 领取后端必备的 200 本书籍

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 后置的文件或者静态资源,抽取部分配置如下

代码语言:javascript
复制
<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

  1. JspServlet 用来处理 jsp 文件
  2. DefaultServlet 会处理/开头的请求,这里重点说下这个 servlet 的处理逻辑,它会处理所有其他 servlet 不匹配的请求,当一个请求过来之后,会先去匹配其他的 servlet,当找不到匹配的 servlet 的时候,才会走 DefaultServlet
  3. 我们可以在项目中的 web.xml 中对 tomcat/config/web.xml 中的配置进行覆盖,即项目中的 web.xml 相对于 tomcat 中的 web.xml 有更高的优先级。

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

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

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

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

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

5、方案 1:使用

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

代码语言:javascript
复制
<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 配置文件中添加如下配置

代码语言:javascript
复制
<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,可以优化下,如下

代码语言:javascript
复制

<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 就无效了

8、案例代码

代码语言:javascript
复制
git地址:https://gitee.com/javacode2018/springmvc-series

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2021-08-10,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 路人甲Java 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 1、本文内容
  • 2、静态资源 & jsp 是被谁处理的?
  • 3、如何让 springmvc 处理所有请求?
  • 4、问题来了:静态资源 404 了
  • 5、方案 1:使用
  • 6、方案 2:使用
  • 7、总结
  • 8、案例代码
相关产品与服务
容器服务
腾讯云容器服务(Tencent Kubernetes Engine, TKE)基于原生 kubernetes 提供以容器为核心的、高度可扩展的高性能容器管理服务,覆盖 Serverless、边缘计算、分布式云等多种业务部署场景,业内首创单个集群兼容多种计算节点的容器资源管理模式。同时产品作为云原生 Finops 领先布道者,主导开源项目Crane,全面助力客户实现资源优化、成本控制。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档