SpringBoot入门(3.0.0)

java加油鸭

已于 2022-12-15 16:05:35 修改

阅读量2.4k

点赞数 2

分类专栏： SpringBoot学习文章标签： spring boot maven spring

于 2022-12-09 10:49:57 首次发布

原文链接：https://docs.spring.io/spring-boot/docs/current/reference/html/getting-started.html#getting-started

版权

SpringBoot学习专栏收录该内容

5 篇文章 1 订阅

订阅专栏

1、SpringBoot介绍

Spring Boot可以帮助我们创建可以运行的独立的、基于Spring的生产级应用程序。 SpringBoot对Spring平台和第三方库采取了开箱即用的方式，这样我们就能以最少的麻烦开始工作。大多数Spring Boot应用程序只需要很少的Spring配置。
SpringBoot的优点：

为所有的Spring开发提供一个根本性的更快、更广泛的入门体验。
开箱即用，但随着需求开始偏离默认值，需要修改默认配置。
提供一系列大类项目常见的非功能特性（如嵌入式服务器、安全、度量、健康检查和外部化配置）
绝对没有代码生成，也不要求XML配置。

2、SpringBoot3.0开发的系统要求

Spring Boot 3.0.1-SNAPSHOT 需要 Java 17支持，并且可以兼容到Java 19，包括Java 19。还需要 Spring Framework 6.0.2 或以上版本。

为以下构建工具提供了明确的构建支持。

构建工具版本

Maven 3.5+

Gradle 7.x (7.5 or later)

2.1. Servlet 容器版本要求

Spring Boot支持以下嵌入式Servlet容器。

Servlet 容器 Servlet 版本

Tomcat 10.0 ; 5.0

Jetty 11.0 5.1

Undertow 2.2 (Jakarta EE 9 variant) 5.0

3、开发第一个SpringBoot项目

3.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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.tellhow</groupId>
    <artifactId>myspringboot</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.1-SNAPSHOT</version>
    </parent>

    <!-- 将在此添加其他行... -->
    <!-- ((只有当你使用 milestone 或 snapshot 版本时，你才需要这个。)) -->
     <!-- 指定依赖jar从哪个远程仓库下载... -->
    <repositories>
        <repository>
            <id>spring-snapshots</id>
            <url>https://repo.spring.io/snapshot</url>
            <snapshots><enabled>true</enabled></snapshots>
        </repository>
        <repository>
            <id>spring-milestones</id>
            <url>https://repo.spring.io/milestone</url>
        </repository>
    </repositories>
      <!-- 指定插件从哪个远程仓库下载... -->
    <pluginRepositories>
        <pluginRepository>
            <id>spring-snapshots</id>
            <url>https://repo.spring.io/snapshot</url>
        </pluginRepository>
        <pluginRepository>
            <id>spring-milestones</id>
            <url>https://repo.spring.io/milestone</url>
        </pluginRepository>
    </pluginRepositories>
</project>

3.2. 添加依赖到类路径下（classpath）

Spring Boot提供了一些 “Starter”【启动器】，每个“Starter”对应着不同的开发场景，我们将这些Starter添加到pom文件中。那么这些场景所需要的依赖就会被加到classpath(类路径)下【换句话来说，Starter是一个依赖的集合，它里面包含了这个场景所需要的所有依赖】。其中，spring-boot-starter-parent 是一个特殊的starter，它在POM.xml 的 dependency-management 里面声明了spring boot的各个依赖及其版本。子项目直接继承它，子项在导入 spring boot 依赖时，就不需要声明版本号。
什么是dependency-management:
在Maven中的作用其实相当于一个对所依赖jar包进行版本管理的管理器。在dependencyManagement下申明的dependencies，Maven并不会去实际下载所依赖的jar，而是在dependencyManagement中用一个Map记录了jar的三维坐标。而被dependencies包裹的元素，Maven是会去仓库实际下载所需要的jar包的，而至于需要下载什么版本的jar包就有两种判断途径：
1、如果dependencies里的dependency自己没有声明version元素，那么maven就会到里面去找有没有对该artifactId和groupId进行过版本声明，如果有，就继承它，如果没有就会报错，告诉你必须为dependency声明一个version
2、如果dependencies中的dependency声明了version，那么无论dependencyManagement中有无对该jar的version声明，都以dependency里的version为准。
所以在我们使用SpringBoot开发的时候，我们在引入外部依赖。没有定义版本，他会去里面去找有没有对该artifactId和groupId进行过版本声明，有的话就去继承它（版本）。

3.3. 编写代码

假设我们想给前端返回hello world,这明显是属于web场景的，所以我们要在pom文件中添加spring-boot-starter-web启动器依赖，并且由于我们在项目中继承spring-boot-starter-parent，所以导入的spring-boot-starter-web启动器不需要写版本号。
1、导入依赖

        <dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>

2、编写业务逻辑代码

@SpringBootApplication
@RestController
public class Application {
	public static void main(String[] args) {
		SpringApplication.run(Application.class, args);
	}
	@RequestMapping("/say")
	@ResponseBody
	public String say(){
		return "hello World";
	}
}

3、启动项目，访问localhost:8080/say就会给浏览器返回hello World。

虽然这里的代码不多，但是Spring在背后帮我们做了很多事情。我们在接下来的几节中逐步介绍重要的部分。

3.3.1. @RestController 和 @RequestMapping 注解

将@RestController标在类上，一般表示这个类是用来处理客户端的请求。@RestController 注解还告诉Spring将返回的结果字符串直接响应给客户端。
@RequestMapping注解是一个用来处理请求地址映射的注解，可用于映射一个请求或一个方法，可以用在类或方法上。

3.3.2. @SpringBootApplication 注解

@SpringBootApplication。这个注解被称为元注解，它结合了 @SpringBootConfiguration、@EnableAutoConfiguration 和 @ComponentScan。
在上面这些注解中，我们最感兴趣的是 @EnableAutoConfiguration。 @EnableAutoConfiguration 告诉Spring Boot根据我们添加的jar依赖项 “猜测” 你想如何配置Spring。由于 spring-boot-starter-web 添加了Tomcat和Spring MVC，自动配置会假定你正在开发一个Web应用，并相应地设置Spring。

3.3.3. “main” 方法

&emsp；我们应用程序的最后部分是 main 方法。这是一个标准的Java入口方法，也就是应用的启动方法。我们的main方法通过调用 run 方法，把应用委托给Spring Boot的 SpringApplication 类。 SpringApplication 引导我们的应用程序启动Spring，而Spring又会启动自动配置的Tomcat网络服务器。我们需要将 MyApplication.class 作为参数传递给 run 方法，以告诉 SpringApplication 哪个是主要的Spring组件。 args 数组也被传入，这是命令行参数。

3.3.4.将应用打成jar包

想创建一个可执行的jar，我们需要在 pom.xml 中添加 spring-boot-maven-plugin 插件。在 pom.xml 的 dependencies 节点下面插入以下几行

<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies> 
	<!--插件-->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>