• -------------------------------------------------------------
  • ====================================

Spring Boot干货系列:(五)开发Web应用之JSP篇

springcloud dewbay 6年前 (2019-04-12) 1879次浏览 已收录 0个评论 扫描二维码

前言

上一篇介绍了 Spring Boot 中使用 Thymeleaf 模板引擎,今天来介绍一下如何使用 SpringBoot 官方不推荐的 jsp,虽然难度有点大,但是玩起来还是蛮有意思的。

正文

先来看看整体的框架结构,跟前面介绍 Thymeleaf 的时候差不多,只是多了webapp 这个用来存放 jsp 的目录,静态资源还是放在 resources 的 static 下面。

引入依赖

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<!–WEB 支持–>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!–jsp 页面使用 jstl 标签–>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
</dependency>

<!–用于编译 jsp–>
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<scope>provided</scope>
</dependency>

使用内嵌的 tomcat 容器来运行的话只要这 3 个就好了。这里介绍下 maven 中 scope 依赖范围的概念,因为后续涉及到这个会有问题。

依赖范围就是用来控制依赖和三种 classpath(编译 classpath,测试 classpath、运行 classpath)的关系,Maven 有如下几种依赖范围:

  • compile:编译依赖范围。如果没有指定,就会默认使用该依赖范围。使用此依赖范围的 Maven 依赖,对于编译、测试、运行三种 classpath 都有效。典型的例子是 spring-code,在编译、测试和运行的时候都需要使用该依赖。
  • test: 测试依赖范围。使用次依赖范围的 Maven 依赖,只对于测试 classpath 有效,在编译主代码或者运行项目的使用时将无法使用此依赖。典型的例子是 Jnuit,它只有在编译测试代码及运行测试的时候才需要。
  • provided:已提供依赖范围。使用此依赖范围的 Maven 依赖,对于编译和测试 classpath 有效,但在运行时候无效。典型的例子是 servlet-api,编译和测试项目的时候需要该依赖,但在运行项目的时候,由于容器以及提供,就不需要 Maven 重复地引入一遍。

application.properties 配置

要支持 jsp,需要在 application.properties 中配置返回文件的路径以及类型

1
2
spring.mvc.view.prefix: /WEB-INF/jsp/
spring.mvc.view.suffix: .jsp

这里指定了返回文件类型为 jsp,路径是在/WEB-INF/jsp/下面。

控制类

上面步骤有了,这里就开始写控制类,直接上简单的代码,跟正常的 springMVC 没啥区别:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
@Controller
@RequestMapping(“/learn”)
public class LearnResourceController {
@RequestMapping(“”)
public ModelAndView index(){
List<LearnResouce> learnList =new ArrayList<LearnResouce>();
LearnResouce bean =new LearnResouce(“官方参考文档”,”Spring Boot Reference Guide”,”http://docs.spring.io/spring-boot/docs/1.5.1.RELEASE/reference/htmlsingle/#getting-started-first-application&#8221;);
learnList.add(bean);
bean =new LearnResouce(“官方 SpriongBoot 例子”,”官方 SpriongBoot 例子”,”https://github.com/spring-projects/spring-boot/tree/master/spring-boot-samples&#8221;);
learnList.add(bean);
bean =new LearnResouce(“龙国学院”,”Spring Boot 教程系列学习”,”http://www.roncoo.com/article/detail/125488&#8243;);
learnList.add(bean);
bean =new LearnResouce(“嘟嘟 MD 独立博客”,”Spring Boot 干货系列 “,”http://tengj.top/&#8221;);
learnList.add(bean);
bean =new LearnResouce(“后端编程嘟”,”Spring Boot 教程和视频 “,”http://www.toutiao.com/m1559096720023553/&#8221;);
learnList.add(bean);
bean =new LearnResouce(“程序猿 DD”,”Spring Boot 系列”,”http://www.roncoo.com/article/detail/125488&#8243;);
learnList.add(bean);
bean =new LearnResouce(“纯洁的微笑”,”Sping Boot 系列文章”,”http://www.ityouknow.com/spring-boot&#8221;);
learnList.add(bean);
bean =new LearnResouce(“CSDN——小当博客专栏”,”Sping Boot 学习”,”http://blog.csdn.net/column/details/spring-boot.html&#8221;);
learnList.add(bean);
bean =new LearnResouce(“梁桂钊的博客”,”Spring Boot 揭秘与实战”,”http://blog.csdn.net/column/details/spring-boot.html&#8221;);
learnList.add(bean);
bean =new LearnResouce(“林祥纤博客系列”,”从零开始学 Spring Boot “,”http://412887952-qq-com.iteye.com/category/356333&#8221;);
learnList.add(bean);
ModelAndView modelAndView = new ModelAndView(“/index”);
modelAndView.addObject(“learnList”, learnList);
return modelAndView;
}
}

jsp 页面编写

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<body style=”background-image: none;”>
<div class=”body_wrap”>
<div class=”container”>
<div class=”alert alert-success text-center” role=”alert”>Sptring Boot 学习资源大奉送,爱我就关注嘟嘟公众号:嘟爷 java 超神学堂</div>
<table class=”table table-striped table-bordered”>
<tr>
<td>作者</td>
<td>教程名称</td>
<td>地址</td>
</tr>
<c:forEach var=”learn” items=”${learnList}”>
<tr class=”text-info”>
<td th:text=”${learn.author}”>嘟嘟 MD</td>
<td th:text=”${learn.title}”>SPringBoot 干货系列</td>
<td><a href=”#” th:href=”${learn.url}” class=”btn btn-search btn-green” target=”_blank”><span>点我</span></a>
</td>
</tr>
</c:forEach>
</table>
</div>
</div>
</body>

启动类

启动类不变还是最简单的

1
2
3
4
5
6
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}

内嵌 Tomcat 容器运行项目

基本配置好了就可以启动项目,通过http://localhost:8080/learn 访问,我使用的 SpringBoot 是1.5.2 版本,jdk1.8,以前介绍过,运行项目有三种方式,这里我都做过了一次测试,发现在 maven 中 jasper 依赖有加 provided 和注释掉该依赖范围运行的效果不大一样,具体对比如下:

有添加 provided 的情况:

  • 右键运行启动类,访问页面报 404 错误
  • 使用 spring-boot:run 运行正常
  • 打包成 jar,通过 java -jar demo-0.0.1-SNAPSHOT.jar 运行报错
  • 打包成 war,通过 java -jar demo-0.0.1-SNAPSHOT.war 运行正常

把 provided 注释掉的情况

  • 右键运行启动类,访问页面正常
  • spring-boot:run 运行 访问页面正常
  • 打包成 jar,通过 java -jar demo-0.0.1-SNAPSHOT.jar 运行报错
  • 打包成 war,通过 java -jar demo-0.0.1-SNAPSHOT.war 运行正常

我测试了好几次都是这样,就是有加 provided 的时候,右键运行启动类访问页面的时候,提示 404 错误。
其他 3 种情况都一样, jar 运行也报 404,spring-boot:run 以及 war 运行都可以。

为什么 jar 包运行不行呢,我们打开打包的 jar 和 war 分别看看区别,如下 2 图所示:


从上面可以看出来,jar 包运行的时候会 404 错误,因为默认 jsp 不会被拷贝进来,而 war 包里面有包含了 jsp,所以没问题。

内嵌 Tomcat 属性配置

关于 Tomcat 的偶有属性都在 org.springframework.boot.autoconfigure.web.ServerProperties 配置类中做了定义,我们只需在 application.properties 配置属性做配置即可。通用的 Servlet 容器配置都已”server”左右前缀,而 Tomcat 特有配置都以”server.tomcat”作为前缀。下面举一些常用的例子。

配置 Servlet 容器

1
2
3
4
5
6
#配置程序端口,默认为 8080
server.port= 8080
#用户绘画 session 过期时间,以秒为单位
server.session.timeout=
# 配置默认访问路径,默认为/
server.context-path=

配置 Tomcat:

1
2
3
4
# 配置 Tomcat 编码,默认为 UTF-8
server.tomcat.uri-encoding=UTF-8
# 配置最大线程数
server.tomcat.max-threads=1000

更为详细的 Servlet 容器配置以及 Tomcat 配置,可以前往博主之前文章查看:Spring Boot 干货系列:常用属性汇总

外部的 Tomcat 服务器部署 war 包

Spring Boot 项目需要部署在外部容器中的时候,Spring Boot 导出的 war 包如果直接在 Tomcat 的部署会报错,不信你可以试试看。
需要做到下面两点修改才可以:

  • 继承 SpringBootServletInitializer
    外部容器部署的话,就不能依赖于 Application 的 main 函数了,而是要以类似于web.xml 文件配置的方式来启动 Spring 应用上下文,此时我们需要在启动类中继承 SpringBootServletInitializer 并实现 configure 方法:1
    2
    3
    4
    5
    6
    public class Application extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
    return application.sources(Application.class);
    }
    }

这个类的作用与在web.xml 中配置负责初始化 Spring 应用上下文的监听器作用类似,只不过在这里不需要编写额外的 XML 文件了。

  • pom.xml 修改 tomcat 相关的配置
    如果要将最终的打包形式改为 war 的话,还需要对 pom.xml 文件进行修改,因为 spring-boot-starter-web中包含内嵌的 tomcat 容器,所以直接部署在外部容器会冲突报错。这里有两种方法可以解决,如下
    方法一:1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
    <exclusion>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    </exclusion>
    </exclusions>
    </dependency>

在这里需要移除对嵌入式 Tomcat 的依赖,这样打出的 war 包中,在 lib 目录下才不会包含 Tomcat 相关的 jar 包,否则将会出现启动错误。
还有一个很关键的关键点,就是 tomcat-embed-jasper 中 scope 必须是 provided。

1
2
3
4
5
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<scope>provided</scope>
</dependency>

因为 SpringBootServletInitializer 需要依赖 javax.servlet,而 tomcat-embed-jasper 下面的 tomcat-embed-core 中就有这个 javax.servlet,如果没用 provided,最终打好的 war 里面会有 servlet-api 这个 jar,这样就会跟 tomcat 本身的冲突了。这个关键点同样适应于下面说的第二种方法。

方法二
直接添加如下配置即可:

1
2
3
4
5
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>

provided 的作用上面已经介绍的很透彻了,这里就不啰嗦了,这种方式的好处是,打包的 war 包同时适合 java -jar 命令启动以及部署到外部容器中。

如果你不喜欢默认的打包名称,你可以通过节点里添加内容。

1
2
3
<build>
<finalName>springBootJsp</finalName>
</bulid>

最后启动 tomcat 输入http://localhost:8080/springBootJsp/learn 查看效果,还是美美哒

关于使用 jar 部署

上面已经测试过了,正常情况下包含 jsp 的页面是无法用 jar 的运行的,因为 jsp 默认是在 webapp 目录下,可是打包成 jar 是没有 webapp 这个目录结构的。

虽然网上有介绍说通过 pom.xml 配置,把 WEB-INF 目录复制到 META-INF/resources 下面。但是博主试了一整天还是访问不了,最后放弃了。各位如何有兴趣可以继续尝试,毕竟 war 也可以通过 java -jar 命令来启动的不是么。

总结

我相信全网都找不到一篇有我这篇这么详细的介绍 Spring Boot 使用 jsp 的文章。有很多人问我,为什么我的很多文章这么简单易懂,我每次都是哭着回复他们四个字:主题阅读,天知道我参考了多少篇网上的文章,外加多少本相关书籍中关于这个章节的内容,反复对比提炼,最后才产出对应的博文。说真的,我很羡慕你们在这个信息爆炸的时代,刚好看到一篇自己要学习的技术的好文章,少走多少弯路。

说了这么多煽情的话,哪位大兄弟带一波节奏啊,好久没收到打赏了 d=====( ̄▽ ̄*)b
想要查看更多 Spring Boot 干货教程,可前往:Spring Boot 干货系列总纲

源码下载

( ̄︶ ̄)↗[相关示例完整代码]

后续补充

最近有网友按照我文章中所示跟着操作,发现就算去掉tomcat-embed-jasper依赖中的<scope>provided</scope>,启动类右键启动的时候访问页面还是 404,研究下了,如果你也是用 IDEA 开发,那么请检查如下图所示是否选择了User classpath of module选项:

snipaste20170401_093234.png
snipaste20170401_092158.png

一直觉得自己写的不是技术,而是情怀,一篇篇文章是自己这一路走来的痕迹。靠专业技能的成功是最具可复制性的,希望我的这条路能让你少走弯路,希望我能帮你抹去知识的蒙尘,希望我能帮你理清知识的脉络,希望未来技术之巅上有你也有我,希望大爷你看完打赏点零花钱给我。


露水湾 , 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权
转载请注明原文链接:Spring Boot干货系列:(五)开发Web应用之JSP篇
喜欢 (0)
[]
分享 (0)
关于作者:
发表我的评论
取消评论

表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址