create-spring-boot-java-project

创建Spring Boot Java项目提示

• 请确保您的系统已安装以下软件：

  • Java 21
  • Docker
  • Docker Compose

• 如果需要自定义项目名称，请更改下载Spring Boot项目模板中的artifactId和packageName

• 如果需要更新Spring Boot版本，请更改下载Spring Boot项目模板中的bootVersion

检查Java版本

• 在终端中运行以下命令检查Java版本

java -version

下载Spring Boot项目模板

• 在终端中运行以下命令下载Spring Boot项目模板

curl https://start.spring.io/starter.zip \
  -d artifactId=${input:projectName:demo-java} \
  -d bootVersion=3.4.5 \
  -d dependencies=lombok,configuration-processor,web,data-jpa,postgresql,data-redis,data-mongodb,validation,cache,testcontainers \
  -d javaVersion=21 \
  -d packageName=com.example \
  -d packaging=jar \
  -d type=maven-project \
  -o starter.zip

解压下载的文件

• 在终端中运行以下命令解压下载的文件

unzip starter.zip -d ./${input:projectName:demo-java}

删除下载的zip文件

• 在终端中运行以下命令删除下载的zip文件

rm -f starter.zip

切换到项目根目录

• 在终端中运行以下命令切换到项目根目录

cd ${input:projectName:demo-java}

添加额外依赖

• 将springdoc-openapi-starter-webmvc-ui和archunit-junit5依赖插入到pom.xml文件中

<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
  <version>2.8.6</version>
</dependency>
<dependency>
  <groupId>com.tngtech.archunit</groupId>
  <artifactId>archunit-junit5</artifactId>
  <version>1.2.1</version>
  <scope>test</scope>
</dependency>

添加SpringDoc、Redis、JPA和MongoDB配置

• 将SpringDoc配置插入到application.properties文件中

# SpringDoc配置
springdoc.swagger-ui.doc-expansion=none
springdoc.swagger-ui.operations-sorter=alpha
springdoc.swagger-ui.tags-sorter=alpha

• 将Redis配置插入到application.properties文件中

# Redis配置
spring.data.redis.host=localhost
spring.data.redis.port=6379
spring.data.redis.password=rootroot

• 将JPA配置插入到application.properties文件中

# JPA配置
spring.datasource.driver-class-name=org.postgresql.Driver
spring.datasource.url=jdbc:postgresql://localhost:5432/postgres
spring.datasource.username=postgres
spring.datasource.password=rootroot
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

• 将MongoDB配置插入到application.properties文件中

# MongoDB配置
spring.data.mongodb.host=localhost
spring.data.mongodb.port=27017
spring.data.mongodb.authentication-database=admin
spring.data.mongodb.username=root
spring.data.mongodb.password=rootroot
spring.data.mongodb.database=test

添加包含Redis、PostgreSQL和MongoDB服务的docker-compose.yaml

• 在项目根目录创建docker-compose.yaml并添加以下服务：redis:6、postgresql:17和mongo:8。

  • redis服务应具有
    • 密码rootroot
    • 映射端口6379到6379
    • 挂载卷./redis_data到/data
  • postgresql服务应具有
    • 密码rootroot
    • 映射端口5432到5432
    • 挂载卷./postgres_data到/var/lib/postgresql/data
  • mongo服务应具有
    • 初始化数据库root用户名root
    • 初始化数据库root密码rootroot
    • 映射端口27017到27017
    • 挂载卷./mongo_data到/data/db

添加.gitignore文件

• 在.gitignore文件中插入redis_data、postgres_data和mongo_data目录

运行Maven测试命令

• 运行maven clean test命令检查项目是否正常工作

./mvnw clean test

运行Maven运行命令（可选）

• （可选）docker-compose up -d启动服务，./mvnw spring-boot:run运行Spring Boot项目，docker-compose rm -sf停止服务。

让我们逐步完成