Spring Boot 2.0 返回JSP页面实战
1. 模板引擎JSP的限制
在开始之前呢，我觉得我们有必要先去了解下 Spring Boot 2.0 官方文档中提到的如下内容：
模板引擎
除了REST Web服务之外，还可以使用Spring MVC来服务动态HTML内容。Spring MVC支持多种模板技术，包括Thymeleaf，FreeMarker，和JSPs。此外，许多其他模板引擎包括它们自己的Spring MVC集成。
Spring Boot 包括以下模板引擎的自动配置支持：
如果可能的话，JSPs应该是可以避免的。因为使用嵌入servlet容器时，有几个已知的限制。
当您使用默认配置的这些模板引擎时，您的模板会自动从 src/main/resources/templates 中提取。
根据您运行应用程序的方式，IntelliJ IDEA以不同的方式排序 classpath。 使用主方法在IDE中运行应用程序会导致与使用Maven或Gradle或从其打包的jar运行应用程序时不同的顺序。 这可能会导致Spring Boot无法在classpath中找到模板。 如果您遇到此问题，可以在IDE中重新排序类路径，以便首先放置模块的类和资源。
或者，您可以配置模板前缀以搜索类路径中的每个模板目录，如下所示：classpath *：/ templates /。
那么由哪些限制呢？
JSP限制
当运行使用嵌入的servlet容器的Spring Boot应用程序（并打包为可执行文件）时，JSP支持中存在一些限制。
- 有了Tomcat，如果你使用war包装，它应该可以工作。 也就是说，一个可执行的war工作，也可以部署到一个标准的容器（不限于，但包括Tomcat）。 由于Tomcat中的硬编码文件模式，可执行jar无法使用。
- 使用Jetty，如果您使用war包装，它应该可以工作。 也就是说，一个可执行的jar有效，并且也可以部署到任何标准容器。
- Undertow不支持JSP。
- 创建自定义error.jsp页面不会覆盖错误处理的默认视图。 应该使用自定义错误页面。
有一个JSP示例，以便您可以看到如何设置。
其实刚开始我有些不太理解官网上面这段话的意思，直到后来我才渐渐理解。
学习Spring Boot 2.0 这么多天，感觉有了更深刻的认识和理解，这里分享下：
Spring Boot 2.0 由于微服务的兴起而被广为人知，当我们在做微服务开发一般需要提供接口返回JSON，在Spring 4.0 以前需要@ResponseBody ＋ @Controller合在一起使用，而在Spring 4.0 之后只需要使用@RestController 即可达到相同的效果。
1. Spring Boot 2.0 更是很友好地吸收了Spring 4.0 开始出现的@RestController.
记忆： @RestController注解相当于@ResponseBody ＋ @Controller合在一起的作用
2. 值得注意的是，当我们使用Spring Boot 2.0 想要返回页面而不是提供json或者xml数据接口的时候，切记不能再使用@RestController了,只能使用@Controller.
3. Spring Boot 2.0 对返回页面 支持FreeMarker,Groovy,Thymeleaf，Muslache 多种模板技术，但是Spring Boot 2.0 缺憾是 由于默认使用内嵌的Tomcat容器，对于JSPs 这种模板技术支持不是很友好，所以我们其实完全可以使用其他的模板引擎技术，避免使用Jsps 模板和使用JSTL标签库
4. Spring Boot 2.0 封装了很多强大的模块和默认的XML配置，大大降低了开发难度。
5. Spring Boot 2.0 不仅 支持Spring MVC (基于Servlet API )，支持Spring WebFlux （基于Reactive Streams API),而且也友好支持redies，mongodb 等No-SQL 数据库 集成以及消息处理中间件等。
6. Spring Boot 2.0 不止支持Spring Cloud 分布式服务框架集成（Spring 全家桶之一），也支持阿里巴巴 开源的 Dubbo 分布式服务框架集成。
2. 开始实战
尽管官网文档中提到使用JSP有一些限制，但是往往我们还是比较习惯想用下JSP，那么如何操作呢？且跟我一步一步来操作。
- 开发工具：Intellij Idea
- JDK 版本：9.0.1
- Maven 版本：3.5.2
2.1 创建一个项目
2.2 选择Spring Initizlizr 帮助我们快速创建Spring Boot 应用
2.3 填写如下项目配置信息
Tips: 注意这里我们使用War 而不是Jar
2.4 勾选web模板支持
2.5 选择项目保存路径
2.6 创建成功后你应该能看到这样的项目结构
2.7 配置JPS页面匹配前后缀路径
application.properties
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
2.8 必须手动创建 webapp/WEB-INF 文件夹
文件夹目录结构如图所示
Tips:这里注意下jsp路径必须和刚才配置的路径保持一致
2.9 修改index.jsp
<%--
Created by IntelliJ IDEA.
User: fairy
Date: 4/6/2018
Time: 9:56 AM
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
Hello World,Spring Boot 2.0 JSP Sample
</body>
</html>
2.10 必须实现SpringBootServletInitializer 接口并且重写方法
我们打开ServletInitializer.java可以看到IDE已经自动为我们实现了这个接口并且重写了这个方法
ServletInitializer.java
package com.xingyun.springbootwebjspsample; import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer; public class ServletInitializer extends SpringBootServletInitializer { @Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
return application.sources(SpringBootWebJspSampleApplication.class);
} }
2.11创建controller 文件夹并且创建HomeController.java
HomeController.java
package com.xingyun.springbootwebjspsample.controller; import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping; @Controller
public class HomeController { @GetMapping("/")
public String home(){
return "index";
}
}
Tips: 这里注意下，我们使用JSP页面的话将不能使用@RestController注解，必须使用@Controller 才得行
2.12 配置POM.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion> <groupId>com.xingyun</groupId>
<artifactId>spring-boot-web-jsp-sample</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging> <name>spring-boot-web-jsp-sample</name>
<description>Demo project for Spring Boot</description> <parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.1.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent> <properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties> <dependencies>
<!-- Web 项目所以添加Spring MVC 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> <!--Provided start-->
<!--War包部署到外部的Tomcat中已经包含了这些，
所以需要添加以下依赖
否则会和内嵌的Tomcat 容器发生冲突
-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
<!--用于编译jsp-->
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<scope>provided</scope>
</dependency>
<!--Provided End-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies> <build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build> </project>
Tips:
我们需要添加web模板支持，所以要添加spring-boot-starter-web
由于我们在JSP页面需要使用JSP标签库，所以要加入JSTL标签库依赖
War包部署到外部的Tomcat中已经包含了这些，所以需要添加以下依赖
spring-boot-starter-tomcat 和 tomcat-embed-jasper
否则会和内嵌的Tomcat 容器发生冲突，并且<scope>provided</scope>不能修改也不能注释掉
关于这个插件如果需要做单元测试，请添加，如果不做单元测试也可以不添加
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<useSystemClassLoader>false</useSystemClassLoader>
</configuration>
</plugin>
2.13 部署war 包
到了最后这一步，千万不要急着Run As Java Application
2.13.1 点击“Edit configurations”
2.13.2 点击‘+’号，选择tomcat Server ---> Local
2.13.3 编辑名称，点击Fix --------> Apply-------> OK
然后点击启动按钮
程序会自动打开：http://localhost:8080
3. 本博文项目案例源码
4. 可能出现的问题
在初次学习时候可能会出现一些常见的异常，可以移步去我的CSDN博客看这篇文章
细数Spring Boot 中容易中招的那些坑
https://blog.csdn.net/hadues/article/details/79334355
@ConfigurationProperties(prefix = "xxx")的值取出为空
https://blog.csdn.net/hadues/article/details/79123645
真正解决方案：java.lang.ClassNotFoundException: javax.xml.bind.JAXBException
https://blog.csdn.net/hadues/article/details/79188793
参考文章：https://www.jianshu.com/p/c544e9a9e96f
IDEA 热部署 https://liuyanzhao.com/7105.html
Spring Boot 2.0 返回JSP页面实战的更多相关文章
- [Spring boot] web应用返回jsp页面
同事创建了一个spring boot项目,上传到svn.需要我来写个页面.下载下来后,始终无法实现在Controller方法中配置直接返回jsp页面. 郁闷了一下午,终于搞定了问题.在此记录一下. 目 ...
- Spring Boot Web项目整合jsp页面访问
这个内容就是实操过程中各种访问不了jsp页面,各种尝试后的解决方案吧.可能不是最优的,但是目前能解决项目中的一些问题.之前觉得没有什么问题直接可以操作的,没想到在这部分还是耗时了. 开发工具idea2 ...
- spring boot 2.0+ 错误页面配置
如果访问了错误的路径,或者后台报错 如果没有一个统一的页面! 或者说页面上展示一堆报错信息,既影响美观,又对用户不友好! 那么如何配置? 定义 ErrorPageConfig,配置错误状态与对应访问路 ...
- Spring Boot 2.0 整合 FreeMarker 模板引擎
本篇博文将和大家一起使用Spring Boot 2.0 和FreeMarker 模板引擎整合实战. 1. 创建新的项目 2. 填写项目配置信息 3. 勾选web 模块 4. 勾选freemarker模 ...
- Spring Boot 2.0 的快速入门（图文教程）
摘要: 原创出处 https://www.bysocket.com 「公众号:泥瓦匠BYSocket 」欢迎关注和转载,保留摘要,谢谢! Spring Boot 2.0 的快速入门(图文教程) 大家都 ...
- Spring Boot 2.0(四)：使用 Docker 部署 Spring Boot
Docker 技术发展为微服务落地提供了更加便利的环境,使用 Docker 部署 Spring Boot 其实非常简单,这篇文章我们就来简单学习下. 首先构建一个简单的 Spring Boot 项目, ...
- 详细介绍Spring Boot 2.0的那些新特性与增强
以Java 8 为基准 Spring Boot 2.0 要求Java 版本必须8以上, Java 6 和 7 不再支持. 内嵌容器包结构调整 为了支持reactive使用场景,内嵌的容器包结构被重构了 ...
- Spring Boot 2.0 升级指南
Spring Boot 2.0 升级指南 前言 Spring Boot已经发布2.0有5个月多,多了很多新特性,一些坑也慢慢被填上,最近有空,就把项目中Spring Boot 版本做了升级,顺便整理下 ...
- Spring Boot 2.0 新特性和发展方向
以Java 8 为基准 Spring Boot 2.0 要求Java 版本必须8以上, Java 6 和 7 不再支持. 内嵌容器包结构调整 为了支持reactive使用场景,内嵌的容器包结构被重构了 ...
随机推荐
- Arbitrage HDU1217
汇率转换问题: 怎么样才能套利 可以用Floyd算法: #include<bits/stdc++.h> using namespace std; ][]; int main() { int ...
- 004 Spark中的local模式的配置以及测试
一:介绍 1.Spark的模式 Local:本地运行模式,主要用于开发.测试 Standalone:使用Spark自带的资源管理框架运行Spark程序,30%左右 Yarn: 将spark应用程序运行 ...
- 文件流 io.StringIo()
import io f = io.StringIO() f.write("") f.getvalue() f.close 二进制 f = io.Bytesio()
- Jetbrains 2018 等系列软件激活破解除去黄色警告框方法（含多个平台）
现在以IDEA 2018软件在windows为例进行讲解破解方法,其它软件及其在不同平台的破解方法原理 大同小异,有需要的有兴趣的可以尝试一下. 最近更新了Intellij IDEA到2018.1.5 ...
- Java 之递归遍历目录
Java 之递归遍历目录 一.内容 输出指定目录(文件夹)下的所有文件(包括目录)的绝对路径 二.源代码:RecursiveListDirectory.java package cn.com.zfc. ...
- 4712: 洪水 基于链分治的动态DP
国际惯例的题面:看起来很神的样子......如果我说这是动态DP的板子题你敢信?基于链分治的动态DP?说人话,就是树链剖分线段树维护DP.既然是DP,那就先得有转移方程.我们令f[i]表示让i子树中的 ...
- BZOJ.2724.[Violet 6]蒲公英(静态分块)
题目链接 区间众数 强制在线 考虑什么样的数会成为众数 如果一个区间S1的众数为x,那么S1与新区间S2的并的众数只会是x或S2中的数 所以我们可以分块先预处理f[i][j]表示第i到第j块的众数 对 ...
- 5410 ACM 杭电 01+完全背包
题目:http://acm.hdu.edu.cn/showproblem.php?pid=5410 虽然是英文题目:但还是很好理解的.明显的背包问题 思路:如果你能想到把题目拆分成小问题,就会简单许多 ...
- c/c++中int main(int argc,char *argv[])的具体含义
int main(int argc,char * argv[ ]) argv为指针的指针 argc为整数 char **argv or: char *argv[ ] or: char argv[ ][ ...
- C、C++、C#、Java、php、python语言的内在特性及区别
C.C++.C#.Java.PHP.Python语言的内在特性及区别: C语言,它既有高级语言的特点,又具有汇编语言的特点,它是结构式语言.C语言应用指针:可以直接进行靠近硬件的操作,但是C的指针操作 ...