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 */@SpringBootApplicationpublic 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;@Controllerpublic 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依赖等其他依赖。