SpringBoot.03.SpringBoot集成jsp

淩亂°似流年 2022-09-10 12:12 274阅读 0赞

### SpringBoot.03.SpringBoot集成jsp ###

*   *  前言
     *  准备工作
     *  jsp集成案例
     *   *  集成步骤
         *   *  1.新建Module
             *  2.pom.xml
             *  3.Springboot03JspApplication.java
             *  4.application.yml
             *  5.index.jsp
             *  6.JspController.java
             *  7.测试
         *  问题分析
         *  解决方案
         *   *  1.springboot:run
             *  2.设置Working directory
         *  修改jsp无须重启应用

## 前言 ##

在SpringBoot中默认推荐使用的模板引擎是Thymeleaf，但是作为传统Web开发的王者jsp在现在的一些企业中仍然被广泛使用。所以对于在SpringBoot中如何使用jsp还是需要有所了解。

> 现在广泛被推崇的是前后端分离，大有替代传统web开发的趋势。而前后端分离模式中VUE对于前端至关重要。所以对于VUE的学习也是必须的。

## 准备工作 ##

由于本次演示SpringBoot.03.SpringBoot集成jsp模板，我们需要jsp页面。这里我们来新建一个jsp模板。

依次选择`File`\->`settings`\->`Editor`\->`File and Code Templates`，然后选中`Files`；在`name`和`Extension`中键入`jsp`，将以下内容填到文本框中

<%@ page pageEncoding="UTF-8" language="java" contentType="text/html; UTF-8" %>
    <!doctype html>
    <html lang="en">
      <head>
          <meta charset="UTF-8">
          <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
          <meta http-equiv="X-UA-Compatible" content="ie=edge">
          <title>这是jsp页面的标题</title>
      </head>
      
      <body>
          <h1>Hello jsp!</h1>
      </body>
    </html>

最后点击`Apply`\->`OK`；如下图所示：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16]

## jsp集成案例 ##

### 集成步骤 ###

#### 1.新建Module ####

我们选择`Spring Initializr`的方式新建一个Module，按照下图填写信息后点击`Next`  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 1]  
在`Dependencies`中选择`Spring Web`，点击`Finish`，如下图所示：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 2]

#### 2.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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.5.4</version>
            <relativePath/>
        </parent>
    
        <groupId>com.christy</groupId>
        <artifactId>springboot-03-jsp</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <name>springboot-03-jsp</name>
        <description>Demo project for Spring Boot</description>
    
        <properties>
            <java.version>1.8</java.version>
        </properties>
    
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                
                <scope>test</scope>
            </dependency>
    
            
            <dependency>
                <groupId>jstl</groupId>
                <artifactId>jstl</artifactId>
                <version>1.2</version>
            </dependency>
    
            
            <dependency>
                <groupId>org.apache.tomcat.embed</groupId>
                <artifactId>tomcat-embed-jasper</artifactId>
            </dependency>
        </dependencies>
    
        <build>
            <plugins>
                
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    </project>

#### 3.Springboot03JspApplication.java ####

import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class Springboot03JspApplication { 
    
        public static void main(String[] args) { 
            SpringApplication.run(Springboot03JspApplication.class, args);
        }
    }

#### 4.application.yml ####

server:
      port: 8803
    
    # 配置视图解析器
    spring:
      mvc:
        view:
          prefix: /
          suffix: .jsp

#### 5.index.jsp ####

我们在webapp目录右键选择新建index.jsp页面，如下图所示：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 3]  
修改jsp页面内容如下：

<%@ page pageEncoding="UTF-8" language="java" contentType="text/html; UTF-8" %>
    <!doctype html>
    <html lang="en">
        <head>
            <meta charset="UTF-8">
            <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
            <meta http-equiv="X-UA-Compatible" content="ie=edge">
            <title>这是jsp页面的标题</title>
        </head>
    
        <body>
            <h1>Hello SpringBoot!</h1>
        </body>
    </html>

#### 6.JspController.java ####

import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    /** * @Author Christy * @Date 2021/9/2 10:02 * @Controller 这里不能使用@RestController注解，否则无法跳转页面只能输出字符串 **/
    @Controller
    @RequestMapping("jsp")
    public class JspController { 
    
        private static final Logger log = LoggerFactory.getLogger(JspController.class);
    
        @RequestMapping("hello")
        public String sayHello(){ 
            log.info("Hello Spring Boot！");
            // 由于我们配置了视图解析器，返回的index会被重定向为url地址：http://localhost:8803/index.jsp
            return "index";
        }
    }

#### 7.测试 ####

我们启动项目，浏览器访问`http://localhost:8803/jsp/hello`，结果如下：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 4]  
一脸懵逼有没有？按理说配置啥的都没有错啊！为啥会404呢？

### 问题分析 ###

之所以出现404原因就是项目并没有找到webapp这个目录，至于更深层次的原因我也不知道。如果哪位大牛能解释这个问题麻烦告知一下。

### 解决方案 ###

#### 1.springboot:run ####

在pom.xml文件中我们集成另外SpringBoot官方的maven插件，那么在右侧边栏`maven`中找到`Plugins`下的`springboot:run`命令运行项目。如下图所示：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_19_color_FFFFFF_t_70_g_se_x_16]  
项目重启后浏览器访问`http://localhost:8803/jsp/hello`，结果如下：  
![在这里插入图片描述][ae96f78d181d40c29fcf28fee38806c0.png]

#### 2.设置Working directory ####

我们选择`Edit Configuration`，在`Working directory`中选择`MODULE_DIR`。如下图所示：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 5]  
项目再次重启后浏览器访问`http://localhost:8803/jsp/hello`，结果如下：  
![在这里插入图片描述][65aaad53b0d54125ab2c9464854dfd9d.png]

> 如果出现访问页面是变成了页面下载，说明jsp页面没有被正确编译和解析。请刷新一下maven重新加载一下依赖；

### 修改jsp无须重启应用 ###

在实际开发过程中页面调试是非常繁琐的，在更改了相应程序之后需要同步刷新页面数据，这就需要频繁的重启应用。对于jsp的集成，SpringBoot提供了一种方法在更改程序或者数据后不需要重启应用，只需要重新刷新页面就可以了。

我们打开配置文件，加上以下代码，内容如下：

server:
      port: 8803
      servlet:
        jsp:
          init-parameters:
            development: true
    
    # 配置视图解析器
    spring:
      mvc:
        view:
          prefix: /     #这个代表jsp的根路径 需要在java包下新建webapp目录
          suffix: .jsp

我们重启应用，访问`http://localhost:8803/jsp/hello`，页面还是显示`Hello SpringBoot!`，然后我们在jsp页面中新增`<h1>Hello Christy!</h1>`，然后刷新页面。结果如下：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 6]

[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220829/7b4b761bb98e481eb5c2c790179c2c8f.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 1]: /images/20220829/12f658e7a3f54e5d854e39ff4818a480.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 2]: /images/20220829/5f96c3e25f214006afe91bcd788a28cd.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 3]: /images/20220829/ad17e85f891d487d8f83cbeb75c1943d.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 4]: /images/20220829/fdf1e65a0c1046a79ea79a1ddee95b09.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_19_color_FFFFFF_t_70_g_se_x_16]: /images/20220829/6c57a06010744f0c93447baea85773ee.png
[ae96f78d181d40c29fcf28fee38806c0.png]: /images/20220829/7109d1559ff742878296faff29eb6778.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 5]: /images/20220829/1165e8fe929b494a85d1588ea3fd1a1f.png
[65aaad53b0d54125ab2c9464854dfd9d.png]: /images/20220829/dfecc592dd0d47a3adc1157cca93e8d8.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5r2u5rGQ5YWI55Sf_size_20_color_FFFFFF_t_70_g_se_x_16 6]: /images/20220829/5d2b928cfebc4343b5c3e6e3034b290d.png