Spring Boot从零到项目部署完整指南

Spring Boot以其简洁、高效的特点，成为了现代Java开发的首选框架。本文将带你从零开始，逐步掌握Spring Boot项目的创建、开发、测试到最终部署的全过程。

一、环境准备

在开始之前，确保你已经安装了以下工具：

• Java JDK：推荐使用JDK 11或更高版本。
• Maven：用于项目构建和依赖管理。
• IDE：推荐使用IntelliJ IDEA或Eclipse。
• Git：用于版本控制。

二、创建Spring Boot项目

1. 使用Spring Initializr

访问Spring Initializr，选择合适的选项：

• Project: Maven Project
• Language: Java
• Spring Boot: 选择最新稳定版
• Project Metadata:
  • Group: com.example
  • Artifact: demo
  • Name: demo
  • Description: Spring Boot Demo
  • Package name: com.example.demo
  • Packaging: Jar
  • Java: 11

点击“GENERATE”，下载生成的项目压缩包并解压。

2. 导入项目到IDE

以IntelliJ IDEA为例：

1. 打开IDEA，选择“Import Project”。
2. 选择解压后的项目目录，点击“Next”。
3. 选择“Maven”项目，点击“Next”。
4. 配置Maven设置，点击“Next”。
5. 点击“Finish”，完成导入。

三、编写Hello World应用

1. 创建Controller

在src/main/java/com/example/demo目录下创建HelloController.java：

package com.example.demo;

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

@RestController
public class HelloController {

    @GetMapping("/")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}

2. 运行项目

在IDE中，找到DemoApplication.java，右键选择“Run 'DemoApplication'”。

打开浏览器，访问http://localhost:8080，你应该能看到“Hello, Spring Boot!”。

四、项目测试

1. 单元测试

在src/test/java/com/example/demo目录下创建HelloControllerTest.java：

package com.example.demo;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.client.TestRestTemplate;
import org.springframework.boot.web.server.LocalServerPort;
import org.springframework.http.ResponseEntity;

import static org.junit.jupiter.api.Assertions.assertEquals;

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class HelloControllerTest {

    @LocalServerPort
    private int port;

    @Autowired
    private TestRestTemplate restTemplate;

    @Test
    public void helloShouldReturnDefaultMessage() {
        ResponseEntity<String> response = restTemplate.getForEntity("http://localhost:" + port + "/", String.class);
        assertEquals("Hello, Spring Boot!", response.getBody());
    }
}

运行测试，确保所有测试通过。

五、项目部署

1. 构建项目

在项目根目录下执行以下命令：

mvn clean package

构建完成后，target目录下会生成一个demo-0.0.1-SNAPSHOT.jar文件。

2. 部署到服务器

将生成的JAR文件上传到服务器，执行以下命令启动应用：

java -jar demo-0.0.1-SNAPSHOT.jar

3. 使用Docker部署

创建Dockerfile

在项目根目录下创建Dockerfile：

FROM openjdk:11-jdk-slim as build
WORKDIR /app
COPY . .
RUN mvn clean package

FROM openjdk:11-jre-slim
COPY --from=build /app/target/demo-0.0.1-SNAPSHOT.jar /app/demo.jar
ENTRYPOINT ["java","-jar","/app/demo.jar"]

构建并运行Docker容器

docker build -t demo-app .
docker run -p 8080:8080 demo-app

打开浏览器，访问http://localhost:8080，你应该能看到“Hello, Spring Boot!”。

六、总结

通过本文，你已掌握了从零开始创建、开发、测试到部署Spring Boot项目的完整流程。无论是本地运行还是使用Docker部署，Spring Boot都展现了其强大的便捷性和灵活性。希望这篇指南能助你在Spring Boot的道路上更进一步！