Spring Boot使用模板引擎JSP实例解析

一、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/springboot-project/tree/master/p17-springboot-jsp