【Spring Boot】（一）Spring Boot 项目的创建和使用

---

前言

在当今的软件开发领域，Spring Boot 是一个备受关注的 Java 框架。它为开发者提供了一种简化和高效的方式来构建 Java 应用程序。本文主要介绍了 Spring Boot 的概念、优点，并且演示了如何使用不同的方式来创建 Spring Boot 项目，最后演示了如何通过 Spring Boot 来输出 “Hello World”。

一、什么是 Spring Boot

1.1 初识 Spring Boot

Spring Boot 是一个用于构建 Java 应用程序的开源框架，它是 Spring Framework 的一个子项目，因此可以说 Spring Boot 项目也是 Spring 项目。Spring Boot 旨在简化和加速 Spring 应用程序的开发过程，通过提供默认配置和自动配置的方式，让开发者可以更专注于业务逻辑的实现，而无需过多的关注繁琐的配置和集成问题。

简单来说，Spring 的诞生是为了简化 Java 程序的开发，而 Spring Boot 的诞生则是为了简化 Spring 程序的开发。

从 Spring Boot 的翻译（Spring 脚手架）就能看出：脚手架是为了修建房屋而搭建的，目的是为了加快房屋的修建速度；Spring 的脚手架，那么就意味着为了加快 Spring 程序的开发而创建的。

1.2 Spring Boot 的核心设计思想

Spring Boot 的核心设计思想是约定大于配置（Convention Over Configuration）和自动配置（Auto-configuration）。

1. 约定大于配置

Spring Boot 是通过一系列的约定来提供默认的行为，使得开发者在大多数情况下无需手动配置，从而减少了项目的复杂性。例如，当创建一个 Spring Boot 的 Web 项目的时候，它会默认配置一个内嵌的 Web 服务器，而无需我们显示地去配置 Tomcat 或者 Jetty 容器。

2. 自动配置
Spring Boot 项目会根据应用程序的依赖和类路径当中的组件，自动为应用程序配置和装配各种功能。这就意味着我们可以在项目中引入一些特定的依赖，Spring Boot 就会自动根据这些依赖来配置相应的功能，从而简化了很多手动配置的过程。

1.3 Spring Boot 的优点

学习和使用 Spring Boot 给我们带来了非常多的便利，例如：

1. 提高开发效率：Spring Boot 的约定大于配置和自动配置功能使得开发的过程更加高效。它大量减少了样板代码的编写，让开发者可以更专注于业务逻辑的实现，从而提高开发效率。

2. 简化配置：Spring Boot 内置了很多默认的配置，让开发者无需手动配置大量的选项。不仅能够减少出错的机会，同时大大降低了项目的复杂性。

3. 嵌入式服务器：Spring Boot 中包含了常用的 Web 服务器，如 Tomcat、Jetty等，这些使得将应用程序打包成可执行的 JAR 文件并运行变得非常简单。不需要额外部署一个独立的 Web 服务器，可以轻松的将应用程序部署到各种环境中。

4. 微服务支持：Spring Boot 对于构建微服务架构提供了很好的支持，可以方便地创建和管理各个微服务，通过 Spring Cloud 项目还可以实现服务注册与发现、负载均衡、断路器模式等微服务相关功能。

5. 大量的起步依赖：Spring Boot 提供了许多预配置的 “Starter” 依赖，涵盖了各种常用的库和框架，例如Spring Data JPA、Spring Security、Thymeleaf等。这些起步依赖简化了集成其他框架的过程，使得构建功能丰富的应用程序变得更加容易。

二、Spring Boot 项目的创建

2.1 使用 IDEA 创建

在使用 IDEA 创建 Spring Boot 项目的时候，如果使用的是社区版，首先需要安装 Spring Boot Helper 插件，但需要注意的是 IDEA 的版本要是 21 版或以前的，因为自 22 版开始，这个插件就收费了。

当然，如果是专业版的话就不需要安装了这个插件了，毕竟是 VIP 嘛。以下演示的是使用 IDEA 2022 专业版创建的 Spring Boot 项目。

1. 首先，使用 IDEA 新建项目

如下图所示：

注意，其中选择使用的JDK版本和默认的Java版本必须保持一致，否则会创建失败。

2. 点击 Next，选择 Spring Boot 版本以及所需要的依赖

在选择版本的时候，由于使用的是 JDK 8，因此选择的 Spring Boot 版本是 2.xx，而 3.xx 的版本需要使用 JDK17等较新版本。

然后选择需要的依赖，

3. 最后选择 Create 创建
   
   如果能够看到其中的启动类，并且有可以运行的三角符号，则说明创建成功了。

2.2 使用网页创建

当使用 IDEA 创建 Spring Boot 项目的时候，我们发现了一个 start.spring.io 的地址，打开这个地址，就可以直接在网页上创建 Spring Boot 项目了。

1. 打开网址

此时可以发现各种各样的选项。其中左侧是一些基本的配置选项，而右侧则是所需依赖的选择。

2. 选择配置

选择的内容和使用 IDEA 创建时选择的一模一样。

2. 选择依赖

3. 下载压缩包

点击 GENERATE 下载压缩包，当然可以点击旁边的 EXPLORE 进行预览。

4. 对刚才下载的压缩包解压，然后使用 IEDA 打开解压后的文件

解压：

使用 IEDA 打开：

5. 此时便成功使用网页创建了一个 Spring Boot 项目了

另外，也可以使用阿里云 start.aliyun.com 来创建，其创建方式一模一样：

2.3 项目的目录结构

当创建完一个 Spring Boot 项目的时候，可以看到其目录结构如下图所示：

这是一个典型的Spring Boot项目的目录结构，下面是各个目录的简要说明：

• src/main/java: 主要Java代码的存放目录。这里通常包含了项目的主要代码逻辑，例如控制器（controller）、模型（model）、数据访问层（repository）等。

• src/main/resources: 主要的资源文件存放目录。在这里，可以放置配置文件、静态资源文件、模板文件等。application.properties或application.yml通常用于配置应用程序的属性。

• src/test: 测试代码的存放目录。在这里，可以编写各种测试用例来测试程序代码。

• pom.xml: Maven项目的配置文件。Maven是Spring Boot项目的默认构建工具，通过pom.xml文件配置项目的依赖和构建设置。

• .mvn：它包含了Maven Wrapper相关的文件，用于在不需要手动安装Maven的情况下执行Maven构建和其他Maven任务。

• mvnw和mvnw.cmd：这是Maven Wrapper的脚本，用于在不安装Maven的情况下执行Maven命令。

• HELP.md：一个Markdown格式的帮助文档文件。它用于提供有关项目的简要介绍、常见问题解答（FAQ）、常用命令、快速入门指南等内容，帮助开发者快速了解和使用项目。

三、Hello World

3.1 运行启动类

点击启动类的 main 方法就可以运行 Spring Boot 项目了，启动成功如下图所示：

通过启动打印的日志记录，可以发现默认使用的端口号是 8080：

3.2 通过浏览器页面输出 Hello World

在 demo 目录下创建一个子目录 controller，然后在里面创建一个 HelloController类。 这是一个简单的 Spring Boot 控制器（Controller）类，用于处理来自/hello路径的 HTTP 请求，并返回 “Hello World” 字符串作为响应。

@Controller
@ResponseBody
public class HelloController {
    
    

    @RequestMapping("/hello")
    public String hello(){
    
    
        return "Hello World";
    }
}

对这段代码的解释如下：

• @Controller：这个注解标记该类为 Spring 的控制器类。它告诉 Spring 框架这是一个处理 HTTP 请求的控制器。

• @RequestMapping("/hello")：这个注解将 /hello 路径映射到 hello() 方法上。当客户端发送请求到 /hello 时，Spring Boot会调用 hello() 方法处理该请求。

• @ResponseBody：这个注解告诉 Spring 将方法的返回值直接作为 HTTP 响应的内容返回，而不是跳转到一个视图页面。在这个例子中，hello() 方法返回的 “Hello World” 字符串会直接作为 HTTP 响应返回给客户端。

这个简单的 Spring Boot 程序演示了如何创建一个基本的控制器，处理一个 HTTP 请求，并返回响应内容。运行这个程序后，当在浏览器中访问http://localhost:8080/hello，将会看到 “Hello World” 这个字符串作为响应输出在浏览器上。

3.3 约定大于配置的体现

在上面的第一个Spring Boot 程序中，我们可以看到约定大于配置的体现，具体如下：

1. 命名约定：在 Spring Boot 中，默认情况下，控制器类和方法的命名约定决定了它们的行为。

   • 在这个例子中，HelloController类被标记为@Controller，因此 Spring Boot 会将其识别为一个控制器类，并处理 HTTP 请求。
   • hello() 方法被标记为@RequestMapping("/hello")，因此它会处理来自/hello路径的HTTP请求。
   • 这些默认的命名约定消除了大量的配置，使得开发者不需要手动配置控制器类和方法与请求路径之间的映射。

2. @ResponseBody注解：在hello()方法中，使用了@ResponseBody注解，这告诉 Spring Boot 将方法的返回值直接作为 HTTP 响应的内容返回。

   • 这意味着我们不需要为hello()方法定义一个额外的视图模板，因为返回的 “Hello World” 字符串会直接成为响应的内容。
   • 这种约定简化了处理响应的过程，让开发者可以专注于业务逻辑而不用担心视图渲染。

3. 默认配置：Spring Boot 提供了大量的默认配置，例如默认的Web服务器（如：Tomcat、Jetty）、默认的数据源配置、默认的日志配置等。这些默认配置在大多数情况下都能满足需求，减少了手动配置的工作。开发者只需要在必要的情况下进行配置覆盖即可。

通过这些约定，我们在上述代码中没有显式地进行大量的配置，而是依赖于 Spring Boot 的约定和默认配置。这样使得代码简洁、易读，并且减少了不必要的冗余代码，提高了开发效率。这就是约定大于配置的典型体现，使得 Spring Boot 应用程序的开发变得更加简单和高效。