Springboot3+JDK17搭建后端項目實戰教程
本文详细介绍了如何使用Spring Boot 3和JDK 17搭建后端项目实战,从环境准备到项目部署的全过程,确保开发者能够快速上手。首先介绍了如何安装和配置JDK 17和Spring Boot 3,接着指导了如何下载并配置开发IDE,然后一步步创建并测试Spring Boot项目,最后展示了如何打包并部署项目。
环境准备
安装 JDK 17
在开始之前,你需要确保你的开发环境已经安装了 JDK 17。你可以通过以下步骤来安装 JDK 17:
-
下载 JDK 17:
访问 Oracle 官方网站,下载 JDK 17 的安装包。注意,Oracle JDK 的部分版本可能需要商业许可,你可以选择使用 OpenJDK 的发行版,如 Adoptium 或 Bellsoft Liberica。 -
安装 JDK 17:
下载完成后,按照安装向导的提示完成 JDK 的安装。安装过程中,确保更新环境变量JAVA_HOME
以及将 JDK 的bin
目录添加到系统的PATH
中。 -
验证安装:
打开命令行窗口,输入以下命令来验证 JDK 是否安装成功:java -version
如果安装成功,你应该能看到类似如下的输出:
java version "17.0.1" 2022-04-22 LTS Java(TM) SE Runtime Environment (build 17.0.1+12-LTS-39) Java HotSpot(TM) 64-Bit Server VM (build 17.0.1+12-LTS-39, mixed mode, sharing)
安装 Spring Boot 3
Spring Boot 3 提供了最新的功能和改进,支持最新的 Java 版本,包括 JDK 17。Spring Boot 3 使用 Spring Boot 的版本管理器来简化安装和更新过程。
-
安装 Spring Boot CLI:
Spring Boot CLI 是一个简单的命令行工具,用于启动和运行 Spring Boot 应用程序。你可以通过以下命令来安装 CLI:curl -s https://api.adoptium.net/v3/assets/feature_releases/17/gates/openjdk17-32-binaries/Linux | grep -o "https.*-linux.tar.gz" | wget -i - tar -xzf OpenJDK* export PATH=$PATH:$PWD/OpenJDK*/bin
安装完成后,你可以通过以下命令验证 CLI 是否安装成功:
spring --version
输出应该类似于:
Spring CLI v3.x.x
-
安装 Spring Boot DevTools:
为了简化开发过程,你可以安装 Spring Boot 的 DevTools,它提供了一些有用的特性,如自动重启、热部署等。在
pom.xml
或build.gradle
文件中添加 DevTools 依赖:<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope> </dependency>
下载并配置 IDE
为了开发 Spring Boot 项目,你需要一个合适的 IDE。推荐使用 IntelliJ IDEA 或 Eclipse。
-
下载并安装 IntelliJ IDEA:
访问 JetBrains 官网 下载并安装 IntelliJ IDEA。选择适合你的版本(社区版或专业版)。 -
配置 IntelliJ IDEA:
打开 IntelliJ IDEA,设置项目的 JDK 版本为 JDK 17。可以通过File -> Project Structure -> Project -> Project SDK
来设置。 - 创建新项目:
在 IntelliJ IDEA 中选择File -> New -> Project
,选择 Spring Initializr,然后选择 Maven 或 Gradle 作为构建工具。选择 JDK 版本为 17,点击Next
,选择 Spring Boot 版本为 3.0.x,点击Next
,然后选择你的项目依赖,点击Finish
。
创建 Spring Boot 项目
使用 Spring Initializr 创建项目
Spring Initializr 是一个在线工具,可以帮助你快速创建 Spring Boot 项目。你可以在 Spring Initializr 官网 上创建项目。
-
选择项目配置:
- Project: Maven Project
- Language: Java
- Spring Boot: 3.0.x
- Packaging: Jar
- Java: 17
- Dependencies: 选择你需要的依赖,例如 Spring Web、Spring Data JPA、Thymeleaf 等。
- 生成项目:
点击Generate
按钮,下载生成的项目压缩包。解压后,你可以将项目导入到 IntelliJ IDEA 中。
添加必要的依赖
在 pom.xml
或 build.gradle
文件中添加必要的依赖。例如,如果你想添加 Spring Web 和 JPA 依赖,可以在 pom.xml
中添加以下内容:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
</dependencies>
在 build.gradle
文件中,你可以添加如下依赖:
dependencies {
implementation 'org.springframework.boot:spring-boot-starter-web'
implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
}
项目基本结构介绍
项目目录结构
一个典型的 Spring Boot 项目目录结构如下:
my-spring-boot-app
│
├── src
│ ├── main
│ │ ├── java
│ │ │ └── com
│ │ │ └── example
│ │ │ └── myapp
│ │ │ ├── MyApplication.java
│ │ │ └── controller
│ │ │ └── MyController.java
│ │ └── resources
│ │ ├── application.properties
│ │ └── static
│ │ └── index.html
│ └── test
│ └── java
│ └── com
│ └── example
│ └── myapp
│ └── MyApplicationTests.java
└── pom.xml
主启动类
主启动类是 Spring Boot 应用程序的入口点。通常命名为 MyApplication.java
,位于 com.example.myapp
包下。
package com.example.myapp;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class MyApplication {
public static void main(String[] args) {
SpringApplication.run(MyApplication.class, args);
}
}
开发 RESTful API
创建控制器
控制器是处理 HTTP 请求的类。通常位于 controller
包下。
package com.example.myapp.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class MyController {
private final MyService myService;
public MyController(MyService myService) {
this.myService = myService;
}
@GetMapping("/hello")
public String hello() {
return myService.getGreeting();
}
}
创建服务层
服务层是处理业务逻辑的类。通常位于 service
包下。
package com.example.myapp.service;
public class MyService {
public String getGreeting() {
return "Hello, World!";
}
}
创建数据访问层
数据访问层是处理数据库操作的类。通常位于 repository
包下。
package com.example.myapp.repository;
import org.springframework.data.jpa.repository.JpaRepository;
import com.example.myapp.model.MyEntity;
public interface MyRepository extends JpaRepository<MyEntity, Long> {
}
创建数据模型
数据模型是数据访问层操作的对象。通常位于 model
包下。
package com.example.myapp.model;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
@Entity
public class MyEntity {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String name;
// Getters and Setters
}
测试 API
使用 Postman 测试 API
Postman 是一个流行的 API 测试工具。你可以通过以下步骤来测试你的 API:
-
安装 Postman:
从 Postman 官网 下载并安装 Postman。 -
创建新请求:
在 Postman 中,选择New
->Request
,输入请求的 URL(如http://localhost:8080/hello
),选择GET
方法,然后点击Send
。 - 查看响应:
如果 API 正常运行,你应该能看到类似于"Hello, World!"
的响应。
单元测试
单元测试用于验证代码的特定部分是否按预期工作。Spring Boot 提供了 MockMvc
工具来测试控制器。
package com.example.myapp;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@WebMvcTest
public class MyControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
public void testHello() throws Exception {
mockMvc.perform(get("/hello"))
.andExpect(status().isOk())
.andExpect(content().string("Hello, World!"));
}
}
部署项目
打包项目
你可以通过 mvn package
或 gradle build
命令来打包项目。
mvn clean package
或
./gradlew clean build
这将生成一个可执行的 JAR 文件,通常位于 target
或 build/libs
目录下。
部署到应用服务器
你可以将生成的 JAR 文件部署到应用服务器上。例如,使用 Tomcat 服务器:
-
下载并安装 Tomcat:
从 Tomcat 官网 下载并安装 Tomcat。 -
部署 JAR 文件:
将生成的 JAR 文件复制到 Tomcat 的webapps
目录下,例如:cp target/my-spring-boot-app.jar /path/to/tomcat/webapps/myapp.jar
-
启动 Tomcat:
启动 Tomcat 服务器:/path/to/tomcat/bin/catalina.sh run
- 访问应用:
打开浏览器,访问http://localhost:8080/myapp
,你应该能看到你的 Spring Boot 应用程序。
共同學習,寫下你的評論
評論加載中...
作者其他優質文章