原文地址:https://docs.spring.io/spring-boot/docs/current/reference/html/
部分章节摘录:
8.介绍Spring Boot
Spring Boot可以轻松创建可以运行的独立的,生产级的基于Spring的应用程序。我们对Spring平台和第三方库进行了一种自以为是的观点,这样您就可以轻松上手了。大多数Spring Boot应用程序只需要很少的Spring配置。
您可以使用Spring Boot创建可以使用java -jar或更传统的war部署启动的Java应用程序 。我们还提供了一个运行“spring脚本”的命令行工具。
我们的主要目标是:
为所有Spring开发提供从根本上更快且可广泛访问的入门体验。
开箱即用,但随着需求开始偏离默认值而迅速摆脱困境。
提供大型项目(例如嵌入式服务器,安全性,度量标准,运行状况检查和外部化配置)通用的一系列非功能性功能。
绝对没有代码生成,也不需要XML配置。
10.1.1 Maven安装
Spring Boot与Apache Maven 3.3或更高版本兼容。如果您还没有安装Maven,可以按照maven.apache.org上的说明进行操作。
以下清单显示了一个典型pom.xml文件:
<?xml version =“1.0”encoding =“UTF-8”?>
<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/xsd/maven-4.0.0.xsd“ >
<modelVersion> 4.0.0 </ modelVersion>
<groupId> com.example </ groupId>
<artifactId> myproject </ artifactId>
<version> 0.0.1-SNAPSHOT </ version>
<! - 继承默认值为Spring Boot - >
<parent>
<groupId> org.springframework.boot </ groupId>
<artifactId> spring-boot-starter-parent </ artifactId>
<version> 2.1.0.RELEASE < / version>
</ parent>
<! - 添加Web应用程序的典型依赖项 - >
<dependencies>
<dependency>
<groupId> org.springframework.boot </ groupId>
<artifactId> spring-boot-starter-web </ artifactId>
</ dependency>
</依赖>
<! - 作为可执行jar的包 - >
<build>
<plugins>
<plugin>
<groupId> org.springframework.boot </ groupId>
<artifactId> spring-boot-maven-plugin </ artifactId>
</ plugin >
</ plugins>
</ build>
</project>
11.开发您的第一个Spring Boot应用程序
本节介绍如何开发一个简单的“Hello World!”Web应用程序,该应用程序突出了Spring Boot的一些主要功能。我们使用Maven来构建这个项目,因为大多数IDE都支持它。
11.1创建POM
我们需要从创建Maven pom.xml文件开始。本pom.xml是用来构建项目的配方。打开您喜欢的文本编辑器并添加以下内容:
<?xml version =“1.0”encoding =“UTF-8”?>
<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/xsd/maven-4.0.0.xsd“ >
<modelVersion> 4.0.0 </ modelVersion>
<groupId> com.example </ groupId>
<artifactId> myproject </ artifactId>
<version> 0.0.1-SNAPSHOT </ version>
<parent>
<groupId> org.springframework.boot </ groupId>
<artifactId> spring-boot-starter-parent </ artifactId>
<version> 2.1.0.RELEASE </ version>
</ parent>
<! - 这里要添加的其他行...... - >
</project>
上面的清单应该为您提供有效的构建。您可以通过运行来测试它mvn package(现在,您可以忽略“jar将为空 - 没有内容标记为包含!”警告)。
11.2添加类路径依赖关系
Spring Boot提供了许多“Starters”,可以将jar添加到类路径中。我们的示例应用程序已经spring-boot-starter-parent在parent POM部分中使用过。这spring-boot-starter-parent是一个特殊的启动器,提供有用的Maven默认值。它还提供了一个 dependency-management 部分,以便您可以省略version“祝福”依赖项的标记。
其他“Starters”提供了在开发特定类型的应用程序时可能需要的依赖项。由于我们正在开发Web应用程序,因此我们添加了 spring-boot-starter-web依赖项。在此之前,我们可以通过运行以下命令来查看当前的内容:
$ mvn依赖:树
[INFO] com.example:myproject:jar:0.0.1-SNAPSHOT
该mvn dependency:tree命令打印项目依赖项的树表示。您可以看到它spring-boot-starter-parent本身不提供依赖关系。要添加必要的依赖项,请编辑pom.xml并spring-boot-starter-web在该parent部分的正下方添加 依赖项:
<dependencies>
<dependency>
<groupId> org.springframework.boot </ groupId>
<artifactId> spring-boot-starter-web </ artifactId>
</ dependency>
</ dependencies>
如果mvn dependency:tree再次运行,您会发现现在有许多其他依赖项,包括Tomcat Web服务器和Spring Boot本身。
11.3编写代码
要完成我们的应用程序,我们需要创建一个Java文件。默认情况下,Maven编译源代码src/main/java,因此您需要创建该文件夹结构,然后添加一个名为src/main/java/Example.java包含以下代码的文件:
import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.web.bind.annotation.*;
@RestController
@EnableAutoConfiguration
public class Example {
@RequestMapping("/")
String home() {
return "Hello World!";
}
public static void main(String[] args) throws Exception {
SpringApplication.run(Example.class, args);
}
}
虽然这里的代码不多,但还是有很多代码。我们将在接下来的几节中逐步介绍重要部分。
11.3.1 @RestController和@RequestMapping注释
我们Example班上的第一个注释是@RestController。这被称为 构造型注释。它为阅读代码的人提供了提示,而对于Spring来说,该类扮演着特定的角色。在这种情况下,我们的类是一个Web @Controller,因此Spring在处理传入的Web请求时会考虑它。
该@RequestMapping注释提供“路由”的信息。它告诉Spring,任何带/路径的HTTP请求都应该映射到该home方法。该 @RestController注解告诉Spring使得到的字符串直接返回给调用者。
[注]
在@RestController与@RequestMapping注解是Spring MVC的注解。(它们不是特定于Spring Boot的。)有关更多详细信息,请参阅Spring参考文档中的MVC部分。
11.3.2 @EnableAutoConfiguration注释
第二个类级注释是@EnableAutoConfiguration。这个注释告诉Spring Boot根据你添加的jar依赖关系“猜测”你想要如何配置Spring。自从spring-boot-starter-web添加了Tomcat和Spring MVC 以来,自动配置假定您正在开发Web应用程序并相应地设置Spring。
启动器和自动配置
自动配置旨在与“启动器”配合使用,但这两个概念并不直接相关。您可以自由选择并在首发之外选择jar依赖项。Spring Boot仍然尽力自动配置您的应用程序。
11.3.3“main”方法
我们的应用程序的最后一部分是main方法。这只是遵循应用程序入口点的Java约定的标准方法。我们的main方法SpringApplication通过调用委托给Spring Boot的类run。 SpringApplication引导我们的应用程序,启动Spring,然后启动自动配置的Tomcat Web服务器。我们需要Example.class作为参数传递给run方法,以告诉SpringApplication哪个是主要的Spring组件。该 args数组也被传递以公开任何命令行参数。
11.4运行示例
此时,您的应用程序应该可以工作。由于您使用了 spring-boot-starter-parentPOM,run因此您可以使用一个有用的目标来启动应用程序。mvn spring-boot:run从根项目目录中键入以启动应用程序。您应该看到类似于以下内容的输出:
$ mvn spring-boot:run
如果您打开Web浏览器localhost:8080,您应该看到以下输出:
你好,世界!
13.5启动器
启动器是一组方便的依赖关系描述符,您可以将其包含在应用程序中。您可以获得所需的所有Spring和相关技术的一站式服务,而无需查看示例代码和复制粘贴依赖描述符的负载。例如,如果要开始使用Spring和JPA进行数据库访问,请spring-boot-starter-data-jpa在项目中包含依赖项。
启动器包含许多依赖项,这些依赖项是使项目快速启动和运行所需的依赖项,以及一组受支持的托管传递依赖项。
名称是什么
所有官方首发都遵循类似的命名模式; spring-boot-starter-*,哪里*是特定类型的应用程序。此命名结构旨在帮助您找到启动器。许多IDE中的Maven集成允许您按名称搜索依赖项。例如,安装了适当的Eclipse或STS插件后,您可以按下ctrl-spacePOM编辑器并输入“spring-boot-starter”以获取完整列表。
正如“ 创建自己的启动器 ”一节中所述,第三方启动者不应该开头spring-boot,因为它是为官方Spring Boot工件保留的。相反,第三方启动器通常以项目名称开头。例如,thirdpartyproject通常会命名一个名为的第三方启动项目 thirdpartyproject-spring-boot-starter。
以下应用程序启动程序由Spring Boot在org.springframework.boot组下提供 :
Table 13.1. Spring Boot application starters
Name | Description | Pom |
---|---|---|
|
Core starter, including auto-configuration support, logging and YAML |
|
|
Starter for JMS messaging using Apache ActiveMQ |
|
|
Starter for using Spring AMQP and Rabbit MQ |
|
|
Starter for aspect-oriented programming with Spring AOP and AspectJ |
|
|
Starter for JMS messaging using Apache Artemis |
|
|
Starter for using Spring Batch |
|
|
Starter for using Spring Framework’s caching support |
|
|
Starter for using Spring Cloud Connectors which simplifies connecting to services in cloud platforms like Cloud Foundry and Heroku |
|
|
Starter for using Cassandra distributed database and Spring Data Cassandra |
|
|
Starter for using Cassandra distributed database and Spring Data Cassandra Reactive |
|
|
Starter for using Couchbase document-oriented database and Spring Data Couchbase |