乐趣区

SpringBoot系列Spring-Boot使用模板引擎JSP

jiezi

一、Java 模板引擎

模板引擎（这里特指用于 Web 开发的模板引擎）是为了使用户界面与业务数据（内容）分离而产生的，它可以生成特定格式的文档，用于网站的模板引擎就会生成一个标准的 HTML 文档。

在 java 中，主要的模板引擎有 JSP、Thymeleaf、FreeMarker、
Velocity 等。

虽然随着前后端分离的崛起和流行，模板引擎已遭受到冷落，但不少旧项目依然使用 java 的模板引擎渲染界面，而偶尔自己写一些练手项目，使用模板引擎也比起前后端分离要来的快速。

本系列会分别讲解 SpringBoot 怎么集成 JSP、Thymeleaf 和 FreeMarker，至于 Velocity，高版本的 SpringBoot 已经不支持 Velocity 了，这里也就不进行讲解了。

而这一篇，主要讲解 Spring Boot 如何集成 JSP。

一、Spring Boot 集成 JSP

首先我们要引入依赖，除了核心的 web 依赖外，就是 jstl 和 tomcat-embed-jasper 了。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!--jsp 页面使用 jstl 标签 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
</dependency>

<!-- 使用 jsp 引擎，springboot 内置 tomcat 没有此依赖 -->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
</dependency>

然后就是配置文件了。主要在 spring.mvc.view 节点下配置视图目录 prefix 和文件后缀 suffix。

server:
  port: 10900

spring:
  profiles:
    active: dev
  mvc:
    view:
      prefix: /templates/ #view 视图文件（jsp）文件的存储位置，不能直接放在 resources 目录下，需要放在 webapp 目录下
      #prefix: /pages/ #或者 resources 下创建 META-INF/resources 目录
      suffix: .jsp #视图文件后缀

这里配置了文件目录为 /templates/，需要主要注意的是，jsp 无法直接放在 resources 目录下，默认会去 src/main/webapp 目录下去寻找，如果没有，则会去 src/main/resources/MATE-INF/resources 目录去寻找，因此使用 JSP，我们就需要将 JSP 文件放在这两个目录下，而配置的 /templates/，即为 src/main/webapp/templates 或者 src/main/resources/MATE-INF/resources/templates。

在 src/main 下创建 webapp/templates 目录，分别新建了 hello.jsp 和 mv.jsp 文件。

<h3>hello jsp</h3>
<h3>mv jsp</h3>
<span>I'm ${name} from mv method</span>

这里主要讲解如何集成 JSP，不对 JSP 语法做过多的讲解，所以仅仅提供了两个简单的 JSP 文件，并简单使用 el 表达式 ${name} 取值。

接着再创建 Controller 类路由页面，该类也十分简单，跳转 hello 页面，以及携带 name=imyang 跳转 mv 页面。

@Controller
@RequestMapping("index")
public class Index {@RequestMapping("/hello")
    public String hello(){return "hello";}

    @RequestMapping("/mv")
    public ModelAndView mv(){ModelAndView mv = new ModelAndView("mv");
        mv.addObject("name","yanger");
        return mv;
    }

}

启动项目，分别访问 http://localhost:10900/index/hello 和 http://localhost:10900/index/mv，可以看到已经可以展示页面信息了。

源码地址：https://github.com/imyanger/s…

退出移动版