域名頻道IDC知識(shí)庫(kù)Spring MVC 是 Spring 提供的一個(gè)基于 MVC 設(shè)計(jì)模式的輕量級(jí) Web 開(kāi)發(fā)框架，其本身就是 Spring 框架的一部分，可以與 Spring 無(wú)縫集成，性能方面具有先天的優(yōu)越性，是當(dāng)今業(yè)界最主流的 Web 開(kāi)發(fā)框架之一。
Spring Boot 是在 Spring 的基礎(chǔ)上創(chuàng)建一款開(kāi)源框架，它提供了 spring-boot-starter-web（Web 啟動(dòng)器） 來(lái)為 Web 開(kāi)發(fā)予以支持。spring-boot-starter-web 為我們提供了嵌入的 Servlet 容器以及 SpringMVC 的依賴(lài)，并為 Spring MVC 提供了大量自動(dòng)配置，可以適用于大多數(shù) Web 開(kāi)發(fā)場(chǎng)景。
Spring Boot 為 Spring MVC 提供了自動(dòng)配置，并在 Spring MVC 默認(rèn)功能的基礎(chǔ)上添加了以下特性：
(1) 引入了 ContentNegotiatingViewResolver 和 BeanNameViewResolver（視圖解析器）
(2) 對(duì)包括 WebJars 在內(nèi)的靜態(tài)資源的支持
(3) 自動(dòng)注冊(cè) Converter、GenericConverter 和 Formatter （轉(zhuǎn)換器和格式化器）
(4) 對(duì) HttpMessageConverters 的支持（Spring MVC 中用于轉(zhuǎn)換 HTTP 請(qǐng)求和響應(yīng)的消息轉(zhuǎn)換器）
(5) 自動(dòng)注冊(cè) MessageCodesResolver（用于定義錯(cuò)誤代碼生成規(guī)則）
(6) 支持對(duì)靜態(tài)首頁(yè)（index.html）的訪問(wèn)
(7) 自動(dòng)使用 ConfigurableWebBindingInitializer
只要我們?cè)?Spring? Boot 項(xiàng)目中的 pom.xml 中引入了 spring-boot-starter-web，即使不進(jìn)行任何配置，也可以直接使用 Spring MVC 進(jìn)行 Web 開(kāi)發(fā)。
創(chuàng)建 Maven Quickstart 項(xiàng)目
??? 1) 系統(tǒng)環(huán)境
Spring Boot 版本及其環(huán)境配置要求如下表。
Spring Boot ?? ? 2.x
JDK ?? ???????????? 8.0 及以上版本
Maven ??? ???????? 3.x
IntelliJ IDEA ?? ? 14.0 以上
本文將在 Windows 下使用 IntelliJ IDEA 和 Apache Maven 創(chuàng)建一個(gè)簡(jiǎn)單的 Maven Quickstart 程序。在開(kāi)始之前，確保已經(jīng)正確搭建了 Spring 開(kāi)發(fā)環(huán)境。
Windows版本 : Windows 10 Home (20H2)
IntelliJ IDEA：Community Edition for Windows 2020.1.4
Apache Maven：3.8.1
??? 2) 運(yùn)行 IDEA 創(chuàng)建項(xiàng)目
點(diǎn)擊菜單 New 創(chuàng)建 Project：
New Project -> Project Type: Maven -> Project SDK: 1.8 -> Check “Create from archtype” -> select “org.apache.maven.archtypes:maven-archtype-quickstart” -> Next
Name: SpringbootWeb
GroupId: com.example
ArtifactId: SpringbootWeb
-> Finish
??? 3) 生成的項(xiàng)目目錄結(jié)構(gòu)和文件
(1) 目錄結(jié)構(gòu)
|– src
|?? |– main
|?? |???? |– java
|?? |?????? |– com
|?? |??????????? |– example
|?? |?????????????????? |– App.java
|?? |– test
|??????? |– java
|?????????????? |– com
|??????????????????? |– example
|?????????????????????????? |– AppTest.java
|– pom.xml
(2) App.java 代碼
package com.example;
public class App {
public static void main( String[] args ) {
System.out.println( “Hello World!” );
}
}
?(3) AppTest.java 代碼
1 package com.example;
2
3 import static org.junit.Assert.assertTrue;
4
5 import org.junit.Test;
6
7 public class AppTest {
8
9 @Test
10 public void shouldAnswerWithTrue() {
11 assertTrue( true );
12 }
13 }
(4) pom.xml 代碼
1 <?xml version="1.0" encoding="UTF-8"?> 2 <project xmlns="http://maven.apache.org/POM/4.0.0" 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 5 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 6 <modelVersion>4.0.0</modelVersion> 7 8 <groupId>com.example</groupId> 9 <artifactId>SpringbootWeb</artifactId> 10 <version>1.0-SNAPSHOT</version> 11 12 <name>SpringbootWeb Maven Webapp</name> 13 <!-- FIXME change it to the project's website --> 14 <url>http://www.example.com</url> 15 16 <properties> 17 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 18 <maven.compiler.source>1.7</maven.compiler.source> 19 <maven.compiler.target>1.7</maven.compiler.target> 20 </properties> 21 22 <dependencies> 23 <dependency> 24 <groupId>junit</groupId> 25 <artifactId>junit</artifactId> 26 <version>4.11</version> 27 <scope>test</scope> 28 </dependency> 29 </dependencies> 30 31 ... 32 33 </project>
1) 導(dǎo)入相關(guān)依賴(lài)包，并修改配置
訪問(wèn) http://www.mvnrepository.com/，查詢(xún) spring-boot-starter-parent 等
修改 pom.xml:
1 <project ... > 2 3 <!-- 把 Maven 默認(rèn)的 JDK 版本從 1.7 改成 1.8 --> 4 <properties> 5 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 6 <maven.compiler.source>1.8</maven.compiler.source> 7 <maven.compiler.target>1.8</maven.compiler.target> 8 </properties> 9 10 ... 11 12 <parent> 13 <groupId>org.springframework.boot</groupId> 14 <artifactId>spring-boot-starter-parent</artifactId> 15 <version>2.6.6</version> 16 <relativePath/> <!-- lookup parent from repository --> 17 </parent> 18 19 <dependencies> 20 21 ... 22 23 <dependency> 24 <groupId>org.springframework.boot</groupId> 25 <artifactId>spring-boot-starter-web</artifactId> 26 </dependency> 27 <dependency> 28 <groupId>org.springframework.boot</groupId> 29 <artifactId>spring-boot-starter-tomcat</artifactId> 30 <scope>provided</scope> 31 </dependency> 32 <dependency> 33 <groupId>org.springframework.boot</groupId> 34 <artifactId>spring-boot-starter-test</artifactId> 35 <scope>test</scope> 36 </dependency> 37 38 ... 39 40 </dependencies> 41 42 ... 43 44 </project>
本文選擇了 spring-boot-starter-parent 2.6.6 相關(guān)依賴(lài)包，spring-boot-starter 和 spring-boot-starter-test 的版本由 spring-boot-starter-parent 控制。
使用 spring-boot-starter-tomcat 將 tomcat 內(nèi)嵌到 web項(xiàng)目中，打包成 jar 后可以直接用 Java 命令行運(yùn)行，不需要再部署到額外的 tomcat 服務(wù)器上。
也可以使用 Jetty 代替 Tomcat，兩者不能同時(shí)內(nèi)嵌，使用 Jetty 可用如下配置代碼代替 Tomcat 的配置代碼：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jetty</artifactId>
</dependency>
2) 修改 src/main/java/com/example/App.java 文件
1 package com.example;
2
3 import org.springframework.boot.SpringApplication;
4 import org.springframework.boot.autoconfigure.SpringBootApplication;
5
6 @SpringBootApplication
7 public class App {
8 public static void main(String[] args) {
9 SpringApplication.run(App.class, args);
10 System.out.println("Spring boot web project");
11 }
12 }
1 package com.example;
2
3 import org.springframework.boot.builder.SpringApplicationBuilder;
4 import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
5
6 public class ServletInitializer extends SpringBootServletInitializer {
7
8 @Override
9 protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
10 return application.sources(App.class);
11 }
12
13 }
1 package com.example.controller;
2
3 import org.springframework.stereotype.Controller;
4 import org.springframework.web.bind.annotation.RequestMapping;
5 import org.springframework.web.bind.annotation.ResponseBody;
6
7 @Controller
8 public class IndexController {
9 @ResponseBody
10 @RequestMapping("/hello")
11 public String hello() {
12 return "Hello page";
13 }
14 }
5) 創(chuàng)建 src/main/resources/application.properties 文件
1 spring.main.banner-mode=off
2
3 # Web server
4 server.display-name=SpringBootWeb-Test
5 server.address=localhost
6 server.port=9090
7
8 # Logging
9 logging.level.com.example=trace
10 logging.file.path=logs
11 logging.pattern.console=%d{yyyy-MM-dd hh:mm:ss} [%thread] %-5level - %msg%n | %logger{50}
12
(1) Run App.main()
Open App.java, click mouse right button, select Run “App.main()”
(2) Edit Configurations
Click “+” add new configuration -> Select “Maven”
Command line: clean spring-boot:run
Name: SpringbootWeb [clean,spring-boot:run]
-> Apply / OK
Click Run “SpringbootWeb [clean,spring-boot:run]”
…
Spring boot web project
訪問(wèn) http://localhost:9090/hello
Hello page
注：打包可以將 Command line 改成 clean package spring-boot:repackage
4. 使用 spring-boot-maven-plugin 插件打包
??? 1) jar 打包
(1) 修改 pom.xml
1 <build> 2 ... 3 4 <!-- 指定 jar 文件名 --> 5 <finalName>SpringbootWeb</finalName> 6 7 <!-- spring-boot-maven-plugin 插件代碼 --> 8 <plugins> 9 <plugin> 10 <groupId>org.springframework.boot</groupId> 11 <artifactId>spring-boot-maven-plugin</artifactId> 12 <configuration> 13 <mainClass>com.example.App</mainClass> 14 </configuration> 15 <executions> 16 <execution> 17 <goals> 18 <goal>repackage</goal> 19 </goals> 20 </execution> 21 </executions> 22 </plugin> 23 </plugins> 24 ... 25 </build>
在IDE中項(xiàng)目列表 -> 點(diǎn)擊鼠標(biāo)右鍵 -> Maven -> Reload Project
?(2) 打包
菜單 View -> Tool Windows -> Maven -> SpringbootWeb -> Lifecycle -> Clean & Package
jar 包生成在目錄 target/ 里
SpringbootWeb.jar
SpringbootWeb.jar.original
注：SpringbootWeb.jar? 包含依賴(lài)包，可以直接運(yùn)行。SpringbootWeb.jar.original 里不包含依賴(lài)的包（要手動(dòng)配置依賴(lài)環(huán)境），運(yùn)行前要把文件名上的 “.original” 去掉。
(3) 運(yùn)行
點(diǎn)擊 IDEA 底部 Terminal 標(biāo)簽頁(yè)，執(zhí)行如下命令。
java -jar target/SpringbootWeb.jar
…
Spring boot web project
訪問(wèn) http://localhost:9090/hello，頁(yè)面顯示：
Hello page
??? 2) war 打包
(1) 修改 pom.xml
1 <!-- war 類(lèi)型設(shè)置 --> 2 <packaging>war</packaging> 3 4 <!-- 注釋掉這個(gè)依賴(lài) 5 <dependency> 6 <groupId>org.springframework.boot</groupId> 7 <artifactId>spring-boot-starter-tomcat</artifactId> 8 <scope>provided</scope> 9 </dependency> 10 --> 11 12 <build> 13 ... 14 <!-- 指定 war 文件名 --> 15 <finalName>SpringbootWeb</finalName> 16 17 <!-- spring-boot-maven-plugin 插件代碼 --> 18 <plugins> 19 <plugin> 20 <groupId>org.springframework.boot</groupId> 21 <artifactId>spring-boot-maven-plugin</artifactId> 22 <configuration> 23 <mainClass>com.example.App</mainClass> 24 </configuration> 25 <executions> 26 <execution> 27 <goals> 28 <goal>repackage</goal> 29 </goals> 30 </execution> 31 </executions> 32 </plugin> 33 </plugins> 34 ... 35 </build>
(2) 打包
菜單 View -> Tool Windows -> Maven -> SpringbootWeb -> Lifecycle -> Clean & Package
war 包生成在目錄 target/ 里
SpringbootWeb.war
SpringbootWeb.war.original
(3) 運(yùn)行
把 SpringbootWeb.war 復(fù)制到獨(dú)立運(yùn)行的 Tomcat 下 webapp 目錄，默認(rèn)設(shè)置的 Tomcat 運(yùn)行在 8080 端口。
Tomcat 會(huì)自動(dòng)解壓 SpringbootWeb.war，在 webapp 下產(chǎn)生 SpringbootWeb 目錄，目錄產(chǎn)生了就可以訪問(wèn) http://localhost:8080/SpringbootWeb/hello ，頁(yè)面顯示：
Hello page