Spring Boot 参考文档

本文档详述了Spring Boot的使用,从介绍、安装、第一个应用开发到启动器、配置类、自动配置等方面,展示了如何快速搭建和配置Spring Boot应用,强调其简化Spring应用程序的初衷,提供自动配置、依赖管理和运行方式。
摘要由CSDN通过智能技术生成

原文地址: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

spring-boot-starter

Core starter, including auto-configuration support, logging and YAML

Pom

spring-boot-starter-activemq

Starter for JMS messaging using Apache ActiveMQ

Pom

spring-boot-starter-amqp

Starter for using Spring AMQP and Rabbit MQ

Pom

spring-boot-starter-aop

Starter for aspect-oriented programming with Spring AOP and AspectJ

Pom

spring-boot-starter-artemis

Starter for JMS messaging using Apache Artemis

Pom

spring-boot-starter-batch

Starter for using Spring Batch

Pom

spring-boot-starter-cache

Starter for using Spring Framework’s caching support

Pom

spring-boot-starter-cloud-connectors

Starter for using Spring Cloud Connectors which simplifies connecting to services in cloud platforms like Cloud Foundry and Heroku

Pom

spring-boot-starter-data-cassandra

Starter for using Cassandra distributed database and Spring Data Cassandra

Pom

spring-boot-starter-data-cassandra-reactive

Starter for using Cassandra distributed database and Spring Data Cassandra Reactive

Pom

spring-boot-starter-data-couchbase

Starter for using Couchbase document-oriented database and Spring Data Couchbase

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值