Spring Boot （Web 篇）：支持JSP

 

目录

前言

在pom.xml加入相关依赖

配置application.properties

创建JSP页面

Controller层

JSP页面

项目启动

第一种方式，SpringBoot直接启动（内置集成tomcat）

浏览器访问

第二种方式，打包成部署的 war 包（外置tomcat）

在pom.xml加入相关依赖

配置启动项

在pom.xml加入相关依赖

添加外置 tomcat

Maven打包

浏览器访问

总结

源码下载

---

前言

SpringBoot虽然支持JSP，但是官方不推荐使用，即：默认并不支持。最开始接触动态页面大多数人都是从JSP开始认识的，虽然真正开发中基本用不到了。但是还是要简单的介绍一下，SpringBoot如何集成JSP页面。

在pom.xml加入相关依赖

有一个很关键的关键点，就是tomcat-embed-jasper中scope必须是provided。

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

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

• compile:编译依赖范围。如果没有指定，就会默认使用该依赖范围。使用此依赖范围的Maven依赖，对于编译、测试、运行三种classpath都有效。典型的例子是spring-code,在编译、测试和运行的时候都需要使用该依赖。

• test: 测试依赖范围。使用次依赖范围的Maven依赖，只对于测试classpath有效，在编译主代码或者运行项目的使用时将无法使用此依赖。典型的例子是Jnuit,它只有在编译测试代码及运行测试的时候才需要。

• provided:已提供依赖范围。使用此依赖范围的Maven依赖，对于编译和测试classpath有效，但在运行时候无效。典型的例子是servlet-api,编译和测试项目的时候需要该依赖，但在运行项目的时候，由于容器以及提供，就不需要Maven重复地引入一遍。

因为SpringBootServletInitializer需要依赖 javax.servlet，而tomcat-embed-jasper下面的tomcat-embed-core中就有这个javax.servlet，如果没用provided，最终打好的war里面会有servlet-api这个jar，这样就会跟tomcat本身的冲突了。

配置application.properties

创建JSP页面

SpringBoot利用工具搭建时，是没有webAPP等目录的，需要手动创建以下目录：

Controller层

注意别加注解@ResponeBody 或者@RestController，控制层根据项目不同，注解不同，建议使用@Controller，不要使用@RestController，毕竟不是每一个方法都返回JSON的，有的需要跳转到界面。

JSP页面

${search}为jstl，在以后的FreeMark同样适用

项目启动

第一种方式，SpringBoot直接启动（内置集成tomcat）

浏览器访问

在浏览器直接输入：http://localhost:8080/index/helloJSP

第二种方式，打包成部署的 war 包（外置tomcat）

在pom.xml加入相关依赖

在这里需要移除对嵌入式Tomcat的依赖，这样打出的war包中，在lib目录下才不会包含Tomcat相关的jar包，否则将会出现启动错误。

配置启动项

让 SpringbootApplication 类继承 SpringBootServletInitializer 并重写 configure 方法，如下：

在pom.xml加入相关依赖

修改 pom.xml 文件，将 jar 改成 war，如下：

添加外置 tomcat

Maven打包

当然，如果对于yml,xml,properties等 类似于 配置的文件，每次有改动都要重新打包，对于clean是为了清除缓存，

٩(๑>◡<๑)۶ 对于我，还是比较喜欢SpringBoot方式启动，鸡肋~

打包成功后，一般会在项目中target中默认存放：

将 war 包部署到 tomcat 容器中运行即可。

浏览器访问

在浏览器直接输入：http://localhost:8080/index/helloJSP，

当然可以直接在tomcat配置首页地址为：http://localhost:8080/index/helloJSP

当然外置 tomcat 也可以选择热部署，类似于SpringBoot热部署：https://blog.csdn.net/Soinice/article/details/82416043

配置完成后，启动tomcat会自动打开浏览器，并访问配置的首页

总结

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

源码下载

[相关示例完整代码]请获取 相关分支哦：feature-20180910-web