IDC知識(shí)庫(kù)
IDC領(lǐng)域?qū)I(yè)知識(shí)百科平臺(tái)

spring-boot-starter-web 簡(jiǎn)介

Spring MVC 是 Spring 提供的一個(gè)基于 MVC 設(shè)計(jì)模式的輕量級(jí) Web 開發(fā)框架,其本身就是 Spring 框架的一部分,可以與 Spring 無(wú)縫集成,性能方面具有先天的優(yōu)越性,是當(dāng)今業(yè)界最主流的 Web 開發(fā)框架之一。

Spring Boot 是在 Spring 的基礎(chǔ)上創(chuàng)建一款開源框架,它提供了 spring-boot-starter-web(Web 啟動(dòng)器) 來(lái)為 Web 開發(fā)予以支持。spring-boot-starter-web 為我們提供了嵌入的 Servlet 容器以及 SpringMVC 的依賴,并為 Spring MVC 提供了大量自動(dòng)配置,可以適用于大多數(shù) Web 開發(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 開發(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 程序。在開始之前,確保已經(jīng)正確搭建了 Spring 開發(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>
3. 配置 Spring Boot Web

1) 導(dǎo)入相關(guān)依賴包,并修改配置

訪問(wèn) http://www.mvnrepository.com/,查詢 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>
? ? ? ? 在IDE中項(xiàng)目列表 -> SpringbootWeb -> 點(diǎn)擊鼠標(biāo)右鍵 -> Maven -> Reload Project

本文選擇了 spring-boot-starter-parent 2.6.6 相關(guān)依賴包,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         }
? ??3) 創(chuàng)建 src/main/java/com/example/ServletInitializer.java 文件
 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         }
? ??4) 創(chuàng)建 src/main/java/com/example/controller/IndexController.java 文件
 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         }
? ? ? ? 注: src/main/java/com/example/controller 目錄不存在,手動(dòng)創(chuàng)建各級(jí)目錄,下同。

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
? ??6) 運(yùn)行

(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>
? ? ? ? ? ? finalName 屬性用來(lái)指定包文件的名稱;

在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? 包含依賴包,可以直接運(yùn)行。SpringbootWeb.jar.original 里不包含依賴的包(要手動(dòng)配置依賴環(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 類型設(shè)置 -->
 2             <packaging>war</packaging>
 3 
 4             <!-- 注釋掉這個(gè)依賴
 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>
? ? ? ? ? ? 在IDE中項(xiàng)目列表 -> 點(diǎn)擊鼠標(biāo)右鍵 -> Maven -> Reload Project

(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

贊(12)
分享到: 更多 (0)

中國(guó)專業(yè)的網(wǎng)站域名及網(wǎng)站空間提供商

買域名買空間