Spring Boot配置外置Tomcat和JSP视图教程（IntelliJ IDEA + Maven）

相信有不少同学跟我一样：

1、相中了Spring Boot强大快捷的配置；

2、项目组及个人的开发习惯选择JSP视图引擎；

3、生产环境基本通过WAR包发布工程（如果使用JSP视图，也只能做成WAR包，Spring Boot内置Tomcat且打成JAR不支持JSP）；

4、使用JSP视图，自然，做开发的时候只能使用外置Tomcat了。（如果使用内置Tomcat，就得打JAR包，可JAR包又不支持JSP！）

基于以上几点需求，我们就搭建一个支持外置Tomcat和JSP视图的Spring Boot项目，具体步骤如下。

步骤一：工具及开发环境

1、IntelliJ IDEA（Eclipse类似）；

2、构建工具：Maven3（Gradle类似）；

3、JDK8

4、Tomcat8

5、Spring Boot 1.5.7.RELEASE

步骤二：搭建Maven WEB工程（如果你熟悉这步，就直接到步骤三）

1、新建工程

2、选择Maven工程，JDK8，通过maven-archetype-webapp创建

3、maven坐标

4、一路next，最后finish

5、finish后，maven就开始帮我们构建工程，直到控制台打印出“BUILD SUCCESS”字样

6、验证Maven是否将工程构建好，如下图所示，打开项目结构对话框，主要验证Artifacts是否生成，

通常都不会生成，如果没生成，不要手工生成，看下一步：（Artifacts就是部署包或者打成部署包包之前的一个目录文件结构）

7、如果Artifacts没生成，打开pom.xml文件，在文件上右键，然后“Maven->Reimport”，

之后再回到项目结构对话框，就能看到Artifacts已经生成了

8、接着，我们按照Maven标准完善一下工程结构，然后在项目结构对话框中配置一下

9、配置tomcat

10、测试Maven web项目

步骤三（重点）：集成Spring Boot

1、配置pom.xml文件：其实这个文件中最重要的就是红色标注的地方，

防止外置tomcat和spring boot内置tomcat的jar包冲突。配置好以后，

再在pom.xml文件上右键“Maven->Reimport”一下。

<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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example.test</groupId>
  <artifactId>helloworld</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>helloworld Maven Webapp</name>
  <url>http://maven.apache.org</url>

  <!-- 继承Spring Boot -->
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.5.7.RELEASE</version>
    <relativePath/>
  </parent>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
    <druid.version>1.1.3</druid.version>
  </properties>

  <dependencies>
    <!-- Spring Boot web依赖 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 运行外部tomcat，打包的时候排除starter-web中依赖的embed tomcat,预防JAR包冲突 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-tomcat</artifactId>
      <scope>provided</scope>
    </dependency>
    <!-- 运行外部tomcat，打包的时候排除EL表达式依赖,预防JAR包冲突 -->
    <dependency>
      <groupId>org.apache.tomcat.embed</groupId>
      <artifactId>tomcat-embed-el</artifactId>
      <scope>provided</scope>
    </dependency>
    <!-- 运行外部tomcat，打包的时候排除tomcat-jdbc依赖,预防JAR包冲突 -->
    <dependency>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat-jdbc</artifactId>
      <scope>provided</scope>
    </dependency>
    <!-- 运行外部tomcat，打包的时候排除tomcat-juli依赖,预防JAR包冲突 -->
    <dependency>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat-juli</artifactId>
      <scope>provided</scope>
    </dependency>
  </dependencies>
  <build>
    <finalName>helloworld</finalName>
    <plugins>
      <!-- spring boot maven打包插件 -->
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

2、创建并配置Spring Boot的配置文件，配置JSP视图路径及后缀

3、编写Spring Boot启动类

package com.example.test.helloworld;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.support.SpringBootServletInitializer;

/**
 * 项目启动入口类，由于是外部tomcat运行项目，所以需要集成SpringBootServletInitializer
 */
@SpringBootApplication
public class Application extends SpringBootServletInitializer {

    /**
     * 外部tomcat运行项目，启动Spring Boot的钩子
     * @param builder
     * @return
     */
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(this.getClass());
    }

    /**
     * Spring Boot本身的Main启动入口
     * @param args
     */
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

3、编写Controller和对应的jsp

package com.example.test.helloworld.controller;

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

@Controller
public class HelloworldController {

    @RequestMapping(value = "/sayHello", method = RequestMethod.GET)
    public String sayHello(Model model) {
        model.addAttribute("name", "Winter");
        return "sayHello";
    }

}

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h2>你好，${name}!</h2>
</body>
</html>

4、启动项目，并访问SyaHello

5、从第4步的结果中，你会发现sayHello.jsp中的EL表达式没有被解释：这主要是由于maven帮我们生成的web.xml的版本是2.3，

2.3默认情况下，jsp中的el表达式会被禁用，2.3以后的版本是默认开启的。如果你依然使用2.3，需要在JSP中做如下设置：

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>

不过，我推荐使用Servlet3.1，所以，你的web.xml需要长下面这种样子：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <display-name></display-name>

</web-app>

最后再重启项目，刷新一下你的页面：

如果你能在你的机器上看到类似上面那个页面，说明你已经搭建好一个外置tomcat和支持JSP视图的maven spring boot项目。

现在，开始你自己的项目吧，maven中添加jstl依赖等其他依赖。