相信有不少同学跟我一样:
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依赖等其他依赖。