create-spring-boot-kotlin-project

创建 Spring Boot Kotlin 项目 Prompt

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

  • 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-kotlin} \
  -d bootVersion=3.4.5 \
  -d dependencies=configuration-processor,webflux,data-r2dbc,postgresql,data-redis-reactive,data-mongodb-reactive,validation,cache,testcontainers \
  -d javaVersion=21 \
  -d language=kotlin \
  -d packageName=com.example \
  -d packaging=jar \
  -d type=gradle-project-kotlin \
  -o starter.zip

解压下载的文件

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

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

删除下载的 Zip 文件

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

rm -f starter.zip

解压下载的文件

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

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

添加额外依赖

• 将 springdoc-openapi-starter-webmvc-ui 和 archunit-junit5 依赖添加到 build.gradle.kts 文件中

dependencies {
  implementation("org.springdoc:springdoc-openapi-starter-webflux-ui:2.8.6")
  testImplementation("com.tngtech.archunit:archunit-junit5:1.2.1")
}

• 将 SpringDoc 配置写入 application.properties 文件

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

• 将 Redis 配置写入 application.properties 文件

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

• 将 R2DBC 配置写入 application.properties 文件

# R2DBC configurations
spring.r2dbc.url=r2dbc:postgresql://localhost:5432/postgres
spring.r2dbc.username=postgres
spring.r2dbc.password=rootroot

spring.sql.init.mode=always
spring.sql.init.platform=postgres
spring.sql.init.continue-on-error=true

• 将 MongoDB 配置写入 application.properties 文件

# MongoDB configurations
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

• 在项目根目录创建 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 服务需包含：
    • initdb root 用户名 root
    • initdb root 密码 rootroot
    • 端口映射：27017 映射到 27017
    • 数据卷挂载：./mongo_data 挂载到 /data/db

• 将 redis_data、postgres_data 和 mongo_data 目录添加到 .gitignore 文件中

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

./gradlew clean test

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

我们一步步来操作。