Spring Boot 核心 JAR 包的实现入门指南

Spring Boot 是一个用于简化 Java 开发的框架，它将复杂的配置和编程减少到最低限度。在许多项目中，你可能会遇到需要将你的应用程序打包成一个 JAR 文件的情况。这篇文章将指导你如何实现 Spring Boot 核心 JAR 包的创建。

整体流程

我们的实现分为以下几个步骤：

步骤 描述
1. 创建项目 使用 Spring Initializr 在线创建项目。
2. 编写代码 实现项目的核心逻辑。
3. 配置 Maven 配置 pom.xml 文件以支持打包。
4. 创建可执行 JAR 构建 Maven 项目并生成可执行 JAR 文件。
5. 运行 JAR 文件 使用命令行运行 JAR 文件。

步骤详解

1. 创建项目

首先，我们可以使用 Spring Initializr 来创建一个新的 Spring Boot 项目。访问 [Spring Initializr]( 并进行以下选择：

  • Project: Maven Project
  • Language: Java
  • Spring Boot: 选择最新稳定版
  • Project Metadata: 填写 Group、Artifact 和其他相关信息
  • Dependencies: 选择 Web 依赖（例如 Spring Web）

生成项目后，将下载的 ZIP 文件解压并导入到你的 IDE 中。

2. 编写代码

在你的项目的主包下创建一个新的 Java 类，例如 DemoApplication.java，并加入以下代码：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * Spring Boot 应用程序入口
 */
@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        // 启动 Spring Boot 应用
        SpringApplication.run(DemoApplication.class, args);
    }
}

在同一包下再创建一个简单的 REST 控制器 HelloController.java：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 一个简单的 REST 控制器，返回欢迎信息
 */
@RestController
public class HelloController {

    /**
     * 处理 GET 请求，返回欢迎信息
     * @return 欢迎字符串
     */
    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}

3. 配置 Maven

接下来，我们需要修改项目的 pom.xml 文件，以确保打包成可执行 JAR。确保以下内容在 pom.xml 中：

<project xmlns="
         xmlns:xsi="
         xsi:schemaLocation=" 
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <dependencies>
        <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>
</project>

4. 创建可执行 JAR

在你的 IDE 中，使用 Maven 命令构建你的项目：

mvn clean package

这个命令会清理项目并打包成 JAR 文件。你可以在 target 目录下找到你的 JAR 文件，如 demo-0.0.1-SNAPSHOT.jar。

5. 运行 JAR 文件

现在，你可以在命令行中通过以下方式运行你的 JAR 文件：

java -jar target/demo-0.0.1-SNAPSHOT.jar

然后，你可以使用浏览器或 Postman 访问 http://localhost:8080/hello，你将看到 "Hello, Spring Boot!" 的返回结果。

状态图

stateDiagram
    [*] --> 创建项目
    创建项目 --> 编写代码
    编写代码 --> 配置 Maven
    配置 Maven --> 创建可执行 JAR
    创建可执行 JAR --> 运行 JAR 文件
    运行 JAR 文件 --> [*]

甘特图

gantt
    title 项目开发时间线
    dateFormat  YYYY-MM-DD
    section 项目阶段
    创建项目         :a1, 2023-10-01, 1d
    编写代码         :a2, after a1  , 2d
    配置 Maven       :a3, after a2  , 1d
    创建可执行 JAR  :a4, after a3  , 1d
    运行 JAR 文件    :a5, after a4  , 1d

最后，恭喜你！你已经成功创建了一个 Spring Boot 核心 JAR 包并运行了它。通过这个过程，你应该对 Spring Boot 的基本结构和 Maven 的配置有了更深入的理解。继续探索，学习更多的知识，你将会在 Java 开发中取得更大的进步！