当前位置：首页 > news >正文

【Spring Boot 入门一】构建你的第一个Spring Boot应用

news 2025/11/1 2:00:07

在这里插入图片描述

一、引言

在当今的软件开发领域，Java一直占据着重要的地位。而Spring Boot作为Spring框架的延伸，为Java开发者提供了一种更加便捷、高效的开发方式。它简化了Spring应用的搭建和配置过程，让开发者能够专注于业务逻辑的实现。无论是构建小型的微服务还是大型的企业级应用，Spring Boot都能发挥巨大的作用。想象一下，你可以在短时间内搭建起一个功能完备、可运行的Java应用，并且无需繁琐的配置，这将大大提高开发效率，减少开发周期。这就是Spring Boot的魅力所在，也是我们深入学习它的原因。

二、环境搭建

（一）安装Java开发环境（JDK）

Windows系统下JDK安装步骤
- 首先，访问Oracle官方网站或者OpenJDK官方网站，下载适合你Windows系统版本（32位或64位）的JDK安装包。例如，如果你使用的是64位Windows 10系统，可以下载JDK 11的64位版本。
- 下载完成后，双击安装包，按照安装向导的提示进行安装。在安装过程中，可以选择安装路径，建议使用默认路径或者选择一个容易记忆且不包含中文和特殊字符的路径，如“C:\Program Files\Java\jdk - 11”。
- 安装完成后，需要配置环境变量。右键点击“此电脑”，选择“属性”，然后点击“高级系统设置”。在“系统属性”窗口中，点击“环境变量”按钮。在“系统变量”中找到“Path”变量，点击“编辑”。在变量值的末尾添加“;C:\Program Files\Java\jdk - 11\bin”（这里的路径是根据你安装JDK的实际路径而定）。
Linux系统下JDK安装步骤
- 对于基于Debian或Ubuntu的系统，可以使用命令行安装OpenJDK。打开终端，输入以下命令：
  - sudo apt - update：更新软件包列表。
  - sudo apt - install openjdk - 11 - jdk：安装OpenJDK 11。
- 对于基于Red Hat或CentOS的系统，可以使用yum命令安装。例如：
  - yum install java - 11 - openjdk - devel。
- 安装完成后，可以通过在终端输入java - version命令来验证JDK是否安装成功。

（二）选择集成开发环境（IDE）

Eclipse
- Eclipse是一个开源的、功能强大的Java集成开发环境。它具有丰富的插件生态系统，可以满足各种开发需求。例如，对于Web开发，可以安装Eclipse Web Tools Platform（WTP）插件。Eclipse的界面布局简洁明了，对于初学者来说比较容易上手。它的代码编辑功能强大，支持代码自动补全、语法检查等功能。
IntelliJ IDEA
- IntelliJ IDEA是一款商业的Java开发工具，也有社区版可供免费使用。它以智能的代码编辑功能而闻名，例如，它能够根据上下文自动推断代码的意图，提供非常精准的代码补全建议。它对Spring Boot项目有很好的支持，在创建、运行和调试Spring Boot应用时非常方便。
- 以IntelliJ IDEA为例，基本配置如下：
  - 下载并安装IntelliJ IDEA社区版或者旗舰版。安装完成后，打开IntelliJ IDEA。
  - 在首次启动时，可以选择导入已有的项目或者创建新项目。对于Spring Boot项目，我们后续会详细介绍创建过程。
  - 在设置中，可以配置JDK的路径。点击“File”->“Project Structure”，在“SDKs”选项卡中添加JDK的安装路径。

三、创建第一个Spring Boot项目

（一）使用Spring Initializr创建项目

访问Spring Initializr网站
- Spring Initializr是一个在线的工具，用于快速创建Spring Boot项目的基础结构。可以通过访问https://start.spring.io/来使用它。
选择项目依赖（如Web、Actuator等）
- 在Spring Initializr的页面上，有很多配置选项。首先，选择项目的构建工具，Maven或者Gradle。这里我们以Maven为例。
- 然后选择项目的语言为Java，Spring Boot的版本（可以选择较新的稳定版本，如2.5.x）。
- 在“Dependencies”（依赖）部分，添加“Web”依赖。这将为我们的项目添加Spring Web相关的库，使得我们能够构建Web应用，例如创建RESTful API。如果想要添加应用的监控功能，可以添加“Actuator”依赖。
下载项目压缩包并导入IDE
- 完成配置后，点击“Generate”按钮，Spring Initializr会生成一个包含项目基础结构的压缩包。
- 将下载的压缩包解压到本地磁盘的一个目录中。然后在IntelliJ IDEA中，选择“File”->“Open”，找到解压后的项目目录，点击“OK”来导入项目。

（二）项目结构分析

主程序类的作用
- 在Spring Boot项目中，有一个主程序类，通常带有@SpringBootApplication注解。例如：
```
package com.example.demo;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class DemoApplication {public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}
}
```
- 这个注解是一个组合注解，它包含了@Configuration、@EnableAutoConfiguration和@ComponentScan等注解。@Configuration表示这个类是一个配置类，可以在其中定义Bean等配置信息；@EnableAutoConfiguration会自动根据项目的依赖和配置进行自动配置，例如，如果添加了Web依赖，它会自动配置Web相关的组件；@ComponentScan会扫描指定包及其子包下的带有@Component、@Service、@Repository等注解的类，并将它们注册为Spring容器中的Bean。
介绍资源文件夹（resources）中的配置文件
- 在resources文件夹下，有一个application.properties或者application.yml文件（如果没有添加其他配置文件的话）。这些文件用于配置Spring Boot应用的各种属性，如服务器端口、数据库连接等。例如，在application.properties中可以设置服务器端口为8081：
```
server.port = 8081
```
说明包结构和类的组织方式
- 在项目中，通常按照功能模块来组织包结构。例如，可以有com.example.demo.controller包用于存放控制器类，com.example.demo.service包用于存放服务类，com.example.demo.repository包用于存放数据访问层的类。这样的组织方式使得项目结构清晰，便于维护和扩展。

四、编写第一个简单的API

（一）创建一个简单的RESTful API

使用@RestController注解创建控制器类
- 在com.example.demo.controller包下创建一个名为HelloController的类，代码如下：
```
package com.example.demo.controller;import org.springframework.web.bind.annotation.RestController;@RestController
public class HelloController {
}
```
- @RestController注解是一个组合注解，它包含了@Controller和@ResponseBody注解。@Controller表示这个类是一个控制器类，用于处理HTTP请求；@ResponseBody表示方法的返回值将直接作为HTTP响应体返回，而不是作为视图名进行解析。

编写一个简单的方法返回固定字符串

在HelloController类中添加一个方法：

package com.example.demo.controller;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class HelloController {@RequestMapping("/hello")public String sayHello() {return "Hello, Spring Boot!";}
}

这里的@RequestMapping注解用于将HTTP请求映射到这个方法上。当客户端发送一个GET请求到/hello路径时，这个方法就会被调用，并返回“Hello, Spring Boot!”这个字符串。

讲解@RequestMapping注解的基本用法
- @RequestMapping注解可以用在类和方法上。当用在类上时，它表示这个类中的所有方法的请求路径都将以这个类上的@RequestMapping注解的值为前缀。例如：
```
package com.example.demo.controller;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/api")
public class HelloController {@RequestMapping("/hello")public String sayHello() {return "Hello, Spring Boot!";}
}
```
- 此时，sayHello方法对应的请求路径是/api/hello。@RequestMapping注解还可以指定请求方法（如GET、POST等），例如：
```
@RequestMapping(value = "/hello", method = RequestMethod.POST)
```
- 这表示这个方法只处理POST请求到/hello路径的情况。

（二）运行项目并测试API

在IDE中运行Spring Boot项目
- 在IntelliJ IDEA中，可以直接点击主程序类中的main方法旁边的绿色运行按钮来运行项目。项目启动后，可以在控制台看到启动日志，其中包含了应用启动的相关信息，如服务器启动在哪个端口等。
使用Postman或浏览器测试API
- 如果使用浏览器测试，可以在浏览器的地址栏中输入http://localhost:8080/hello（如果没有修改服务器端口的话），就可以看到浏览器显示“Hello, Spring Boot!”。
- 如果使用Postman测试，可以打开Postman，创建一个新的GET请求，输入http://localhost:8080/hello作为请求地址，然后点击“Send”按钮，在响应体中就可以看到“Hello, Spring Boot!”这个结果。

五、深入理解自动配置

（一）什么是Spring Boot自动配置

解释自动配置的概念和原理
- Spring Boot的自动配置是其核心特性之一。它基于条件注解（如@Conditional系列注解）来根据项目的依赖和环境自动配置Spring容器中的Bean。例如，当项目中添加了spring - web依赖时，Spring Boot会自动配置一个嵌入式的Web服务器（如Tomcat），并且配置相关的Servlet、Filter等组件。
- 原理上，Spring Boot在启动时会扫描类路径下的各种配置类和Bean定义。对于自动配置类，它们会根据条件判断是否需要进行配置。这些条件可以基于类是否存在、环境变量是否设置、配置文件中的属性是否满足等。例如，有一个自动配置类可能会检查类路径下是否存在某个数据库驱动类，如果存在，则会自动配置数据库连接相关的Bean。
举例说明自动配置如何简化开发
- 假设我们要创建一个简单的Web应用，在传统的Spring开发中，我们需要手动配置一个Web服务器，如Tomcat。这包括创建Tomcat实例，配置端口号，设置Servlet上下文等一系列复杂的操作。而在Spring Boot中，只需要添加spring - web依赖，Spring Boot就会自动配置好一个嵌入式的Tomcat服务器，并且默认将服务器端口设置为8080。我们可以直接编写业务逻辑代码，无需关心Web服务器的底层配置。

（二）查看自动配置的生效情况

使用@Conditional相关注解的例子

我们可以创建一个自定义的自动配置类来演示。首先创建一个名为MyAutoConfiguration的类：

package com.example.demo.config;import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.context.annotation.Configuration;@Configuration
@ConditionalOnClass(name = "javax.servlet.Servlet")
public class MyAutoConfiguration {// 这里可以定义一些Bean或者配置信息
}

这个自动配置类使用了@ConditionalOnClass注解，它表示只有当类路径下存在javax.servlet.Servlet类时，这个自动配置类才会生效。

在日志中查看自动配置的加载信息
- 在项目启动时，可以在控制台的启动日志中查看自动配置的加载情况。Spring Boot会打印出哪些自动配置类被加载了，哪些被排除了（如果有）。例如，可以看到类似这样的日志：
```
o.s.b.a.autoconfigure.web.servlet.WebMvcAutoConfiguration :
WebMvcAutoConfiguration matched:
- @ConditionalOnClass found required classes 'javax.servlet.Servlet', 'org.springframework.web.servlet.DispatcherServlet' (OnClassCondition)
```
- 这表示WebMvcAutoConfiguration这个自动配置类被加载了，并且满足了@ConditionalOnClass注解的条件。

六、总结与展望

在这篇文章中，我们从Spring Boot的环境搭建开始，包括JDK的安装和IDE的选择，然后使用Spring Initializr创建了第一个Spring Boot项目，并详细分析了项目的结构。接着编写了一个简单的RESTful API，深入理解了@RestController和@RequestMapping等注解的用法，还运行项目并进行了API测试。最后，我们深入探讨了Spring Boot的自动配置特性，包括其概念、原理、示例以及如何查看自动配置的生效情况。通过这些内容，大家应该对Spring Boot有了一个初步的认识和理解。在下一篇文章中，我们将深入探讨Spring Boot中的配置文件，包括不同类型的配置文件、自定义配置属性以及配置文件与不同环境的关系等内容，进一步深入Spring Boot的世界。