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使用场景,内嵌的容器包结构被重构了 ...
随机推荐
- BZOJ1477 青蛙的约会 扩展欧几里德
欢迎访问~原文出处——博客园-zhouzhendong 去博客园看该题解 题目传送门 - BZOJ1477 题意概括 两只青蛙,现在分别在x,y的位置,以m,n的速度在周长为L的环形跑道上面跑. 问他 ...
- BZOJ1059 [ZJOI2007]矩阵游戏 二分图匹配 匈牙利算法
欢迎访问~原文出处——博客园-zhouzhendong 去博客园看该题解 题目传送门 - BZOJ1059 题意概括 有一个n*n(n<=200)的01矩阵,问你是否可以通过交换整行和整列使得左 ...
- PTA 7-2 是否完全二叉搜索树（30 分） 二叉树
将一系列给定数字顺序插入一个初始为空的二叉搜索树(定义为左子树键值大,右子树键值小),你需要判断最后的树是否一棵完全二叉树,并且给出其层序遍历的结果. 输入格式: 输入第一行给出一个不超过20的正整数 ...
- java连接数据库(jdbc)调用配置文件
各种语言都有自己所支持的配置文件,后缀名“.properties”结尾的就是其中之一. 在java连接数据库时,采取读取配置文件的方式,来获取数据库连接. 新建jdbc.properties文件,内容 ...
- [OpenCV-Python] OpenCV 中的图像处理 部分 IV (一)
部分 IVOpenCV 中的图像处理 OpenCV-Python 中文教程(搬运)目录 13 颜色空间转换 目标 • 你将学习如何对图像进行颜色空间转换,比如从 BGR 到灰度图,或者从BGR 到 ...
- 内置函数 filter zip map
1. 基本内置函数: 2. enumerate : 枚举 把列表转化为有索引的字典: 3. eval 和 exec 4. 过滤函数 filter 5. map 函数批量修改: 6. 配对函数 zi ...
- drupal笔记
$app_root :网站根目录 安装 汉化:1将汉化包放置drupal8\sites\default\files\translations下安装:2极简版的话需要在extend(扩展)中安装Inte ...
- python tkinter-消息框、对话框、文件对话框
python tkinter-消息框.对话框.文件对话框 消息框 导入 import tkinter import tkinter.messagebox #这个是消息框,对话框的关键 提示消息框 ...
- AGC027 D - Modulo Matrix 构造
目录 题目链接 题解 代码 题目链接 AGC027 D - Modulo Matrix 题解 从第左上角第一个点开始染色,相邻不同色,染法唯一 那么一个点的四周与他不同色,我们另这个点比四周都大,那么 ...
- LCD带字符液晶显示Ｉ ＬＯＶＥ YOU
1602是字符型液晶,内含128个ASCLL字符型的字符库,故可以显示ASCLL字符,而不能显示汉字. 1602可以显示两行信息,每行16个字符,5V电源供电,带有背光. 知识点: #include ...