开发首个Spring Boot应用
📋 前置条件
🎯 在开始之前,请打开终端并运行以下命令以确保已安装正确版本的 Java:
$ java -version
openjdk version "17.0.4.1" 2022-08-12 LTS
OpenJDK Runtime Environment (build 17.0.4.1+1-LTS)
OpenJDK 64-Bit Server VM (build 17.0.4.1+1-LTS, mixed mode, sharing)
⚠️ | 注意 | 本示例需要在独立目录中创建。后续操作假设您已创建合适目录并已切换至该目录。
🔧 构建工具配置
1️⃣ Maven 配置
🔍 若使用 Maven 构建工具,请验证安装情况:
$ mvn -v
Apache Maven 3.8.5 (3599d3414f046de2324203b78ddcf9b5e4388aa0)
Maven home: usr/Users/developer/tools/maven/3.8.5
Java version: 17.0.4.1, vendor: BellSoft, runtime: /Users/developer/sdkman/candidates/java/17.0.4.1-librca
2️⃣ Gradle 配置
🔍 若使用 Gradle 构建工具,请验证安装情况:
$ gradle --version------------------------------------------------------------
Gradle 8.1.1
------------------------------------------------------------Build time: 2023-04-21 12:31:26 UTC
Revision: 1cf537a851c635c364a4214885f8b9798051175bKotlin: 1.8.10
Groovy: 3.0.15
Ant: Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM: 17.0.7 (BellSoft 17.0.7+7-LTS)
OS: Linux 6.2.12-200.fc37.aarch64 aarch64
🧩 Maven 项目配置
📝 首先创建 Maven 的 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.example</groupId><artifactId>myproject</artifactId><version>0.0.1-SNAPSHOT</version><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.4.5</version></parent><!-- 后续添加其他配置 -->
</project>
🔄 运行 mvn package
命令可验证配置(暂时可忽略"jar will be empty"的警告提示)。
💡 | 说明 | 此时可将项目导入 IDE 开发环境(主流 Java IDE 均内置 Maven 支持)。为保持示例简洁,我们继续使用文本编辑器操作。
🧩 Gradle 项目配置
📝 首先创建 Gradle 的 build.gradle
构建脚本:
plugins {id 'java'id 'org.springframework.boot' version '3.4.5'
}apply plugin: 'io.spring.dependency-management'group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'repositories {mavenCentral()
}dependencies {
}
🔄 运行 gradle classes
命令可验证基础配置。
💡 | 说明 | 此时也可将项目导入 IDE 开发环境(主流 IDE 均支持 Gradle)。为保持过程简洁,我们继续使用文本编辑器操作。
📦 添加依赖项
✨ Spring Boot 提供多种 starter 组件,可便捷管理依赖项。这些 starter 包含了开发特定类型应用所需的常用库。
1️⃣ Maven 项目
📌 在 POM 文件的 <parent>
节点中引用 spring-boot-starter-parent
能够获得:
- 智能化的 Maven 默认配置
- 依赖版本自动管理功能(对标注为"blessed"的依赖可省略版本号)
🌐 需要添加 spring-boot-starter-web
依赖。添加前可通过以下命令查看当前依赖树:
$ mvn dependency:tree
[INFO] com.example:myproject:jar:0.0.1-SNAPSHOT
📌 在 <parent>
节点下方添加依赖配置:
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
</dependencies>
🔄 再次运行依赖树查看命令,可见新增了 Tomcat 服务器和 Spring Boot 核心库等依赖。
2️⃣ Gradle 项目
📌 通过 org.springframework.boot
插件可获得:
- 智能化的 Gradle 任务配置
- 通过
io.spring.dependency-management
插件实现的依赖版本管理
🌐 添加 Web 应用依赖前,先查看当前依赖树:
$ gradle dependencies
> Task :dependencies
Root project 'myproject'
📌 在 dependencies
节点中添加配置:
dependencies {implementation 'org.springframework.boot:spring-boot-starter-web'
}
🔄 再次执行依赖分析后,可见已成功引入 Tomcat 服务器和 Spring Boot 核心组件。