SpringBoot2.x系列教程09--SpringBoot中支持jsp页面

imodouAbout 5 minSpringBoot

SpringBoot2.x系列教程09--SpringBoot中支持jsp页面

前言

在上一章节中跟大家讲过现在项目比较流行的开发模式，稍微大点的项目一般都是采用前后端分离的开发模式。如果我们的项目采用的是前后端不分离的模式，在SpringBoot中推荐我们使用Themeleaf模板来作为页面。

但是咱们都知道，Spring MVC中是支持JSP的，但是在Spring Boot中，其实不建议我们使用JSP。因为SpringBoot自带的嵌入式servlet容器对jsp的解析有使用限制，而且jsp的本质是Servlet，每个页面的加载都需要先进行编译，所以jsp的效率相对于html或Themeleaf都比较低。

但是如果你非要在Spring Boot中使用jsp可不可以呢？还是那句话，既然你有这样另类的需求那就想办法满足你呗，接下来我们就在SpringBoot中实现对jsp的支持。

一. 搭建jsp运行环境

前面我一直在说，本系列教程的所有项目代码，都会在同一个父项目下创建，所以我们继续在之前的项目中创建一个新的模块，创建过程请参考之前的文章。

1. 创建Maven web module

我们这里直接在之前的project中创建一个新的module。

设置新模块的名称，各位随意即可。

2. 改造项目为Spring Boot项目

在新模块demo06的pom.xml文件中，请添加相关依赖和插件。

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.2.5.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<build>
    <plugins>
        <plugin>
           <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
       </plugin>
    </plugins>
</build>

3. 添加web相关依赖

这里我们一定要在pom.xml文件中，添加web和jsp等相关依赖包。

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- servlet 依赖. -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
    </dependency>
    <dependency>
        <groupId>org.apache.tomcat.embed</groupId>
        <artifactId>tomcat-embed-jasper</artifactId>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

4. 在application.properties中配置支持jsp

除了添加上述依赖包之外，我们还要在application.properties配置文件中，设置逻辑视图名等配置信息，添加对jsp的支持，配置jsp模板文件的存放路径。

spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE HTML>
<%@ taglib prefix="spring" uri="http://www.springframework.org/tags"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<html>
<head>
    <meta charset="UTF-8">
    <title>Boot支持JSP!</title>
</head>
<body>
<h2>Hello ${msg}</h2>
</body>
</html>

2. 创建一个Controller类

这里我创建一个Controller接口，并在这里进行页面跳转和传值的设置。

package com.yyg.boot.web;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

/**
 * Spring Boot中支持jsp功能的实现
 */
@Controller
public class JspController {

    @GetMapping("/index")
    public String index(Model model) {
        model.addAttribute("msg","跟一一哥学习SpringBoot中使用JSP功能!");
        //要跳转到的页面视图名称
        return "index";
    }

}

3. 创建启动类

最后我们在项目的根目录com.yyg.boot下创建一个启动类。

@SpringBootApplication
public class JspApplication  {
    //注意:不要直接启动该类,要以spring-boot:run命令方式启动才行,否则404!!!
    public static void main(String[] args) {
        SpringApplication.run(JspApplication.class, args);
    }
}