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

分手后的思念是犯贱 2023-10-14 14:03 12阅读 0赞

### 文章目录 ###

*  前言
 *  一、什么是 Spring Boot
 *   *  1.1 初识 Spring Boot
     *  1.2 Spring Boot 的核心设计思想
     *  1.3 Spring Boot 的优点
 *  二、Spring Boot 项目的创建
 *   *  2.1 使用 IDEA 创建
     *  2.2 使用网页创建
     *  2.3 项目的目录结构
 *  三、Hello World
 *   *  3.1 运行启动类
     *  3.2 通过浏览器页面输出 Hello World
     *  3.3 约定大于配置的体现

--------------------

# 前言 #

在当今的软件开发领域，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 版开始，这个插件就收费了。  
![74dd4c992b3f4a0d8e2484baef38352c.png][]  
当然，如果是专业版的话就不需要安装了这个插件了，毕竟是 VIP 嘛。以下演示的是使用 IDEA 2022 专业版创建的 Spring Boot 项目。

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

如下图所示：  
![30d7c644b29043a995fbadd196c626e8.png][]  
注意，其中选择使用的JDK版本和默认的Java版本必须保持一致，否则会创建失败。

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

在选择版本的时候，由于使用的是 JDK 8，因此选择的 Spring Boot 版本是 2.xx，而 3.xx 的版本需要使用 JDK17等较新版本。  
![f00f993c36264fd98bf7eb1263e5cdc1.png][]  
然后选择需要的依赖，  
![bdba9230b12c4686b92eda80dc8df955.png][]

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

## 2.2 使用网页创建 ##

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

1.  打开网址

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

1.  选择配置

![8542ce6b600f4622821b4fd133903d10.png][]  
选择的内容和使用 IDEA 创建时选择的一模一样。

1.  选择依赖

![e0b8dc33ef9748c0a87badf34d3c7c10.png][]

1.  下载压缩包

![52da67129a264b8899a35eff0ca9bac8.png][]  
点击 `GENERATE` 下载压缩包，当然可以点击旁边的 `EXPLORE` 进行预览。

![7f2d4042365c422085bcd417a981a7b1.png][]

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

解压：  
![a2597945b1d64374a1ee1009c1938e94.png][]

使用 IEDA 打开：

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

![ed6d567c30334b03b2f3111f54f42d4c.png][]

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

![9575a8705733445db6509b822a97f402.png][]

## 2.3 项目的目录结构 ##

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

![d43d9f4c15604be9ba53b80e3934b6c2.png][]

这是一个典型的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 项目了，启动成功如下图所示：  
![6df6eb62f2ed44b6bfb826e344572e9a.png][]

通过启动打印的日志记录，可以发现默认使用的端口号是 8080：  
![4fb8abcc667e4eae94f39014fa7064cd.png][]

## 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” 这个字符串作为响应输出在浏览器上。

![9912cf3f071a486b85bf95ce303ee8e8.png][]

## 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 应用程序的开发变得更加简单和高效。

[74dd4c992b3f4a0d8e2484baef38352c.png]: https://img-blog.csdnimg.cn/74dd4c992b3f4a0d8e2484baef38352c.png
[30d7c644b29043a995fbadd196c626e8.png]: https://img-blog.csdnimg.cn/30d7c644b29043a995fbadd196c626e8.png
[f00f993c36264fd98bf7eb1263e5cdc1.png]: https://img-blog.csdnimg.cn/f00f993c36264fd98bf7eb1263e5cdc1.png
[bdba9230b12c4686b92eda80dc8df955.png]: https://img-blog.csdnimg.cn/bdba9230b12c4686b92eda80dc8df955.png
[0a08c47b47674dc9bae81c22a9ca1754.png]: https://img-blog.csdnimg.cn/0a08c47b47674dc9bae81c22a9ca1754.png
[start.spring.io]: https://start.spring.io
[071cf29bd5d64c41ad2c0ca4fee601dd.png]: https://img-blog.csdnimg.cn/071cf29bd5d64c41ad2c0ca4fee601dd.png
[a720b02804f04df283595a565a7c2c66.png]: https://img-blog.csdnimg.cn/a720b02804f04df283595a565a7c2c66.png
[8542ce6b600f4622821b4fd133903d10.png]: https://img-blog.csdnimg.cn/8542ce6b600f4622821b4fd133903d10.png
[e0b8dc33ef9748c0a87badf34d3c7c10.png]: https://img-blog.csdnimg.cn/e0b8dc33ef9748c0a87badf34d3c7c10.png
[52da67129a264b8899a35eff0ca9bac8.png]: https://img-blog.csdnimg.cn/52da67129a264b8899a35eff0ca9bac8.png
[7f2d4042365c422085bcd417a981a7b1.png]: https://img-blog.csdnimg.cn/7f2d4042365c422085bcd417a981a7b1.png
[a2597945b1d64374a1ee1009c1938e94.png]: https://img-blog.csdnimg.cn/a2597945b1d64374a1ee1009c1938e94.png
[da3d3479842e4d67862d005790428a21.png]: https://img-blog.csdnimg.cn/da3d3479842e4d67862d005790428a21.png
[ed6d567c30334b03b2f3111f54f42d4c.png]: https://img-blog.csdnimg.cn/ed6d567c30334b03b2f3111f54f42d4c.png
[start.aliyun.com]: https://start.aliyun.com/
[9575a8705733445db6509b822a97f402.png]: https://img-blog.csdnimg.cn/9575a8705733445db6509b822a97f402.png
[d43d9f4c15604be9ba53b80e3934b6c2.png]: https://img-blog.csdnimg.cn/d43d9f4c15604be9ba53b80e3934b6c2.png
[6df6eb62f2ed44b6bfb826e344572e9a.png]: https://img-blog.csdnimg.cn/6df6eb62f2ed44b6bfb826e344572e9a.png
[4fb8abcc667e4eae94f39014fa7064cd.png]: https://img-blog.csdnimg.cn/4fb8abcc667e4eae94f39014fa7064cd.png
[9912cf3f071a486b85bf95ce303ee8e8.png]: https://img-blog.csdnimg.cn/9912cf3f071a486b85bf95ce303ee8e8.png