# Kotlin Spring Boot 模式 ## 项目配置 // 构建.gradle.kts 插件{ kotlin（“jvm”）版本“2.2.21” kotlin（“plugin.spring”）版本“2.2.21” id（“org.springframework.boot”）版本“3.5.7” } 依赖项{ 实现（“org.springframework.boot：spring-boot-starter-web”）实现（“org.springframework.boot：spring-boot-starter-data-jdbc”）实现（“org.springframework.boot：spring-boot-starter-validation”）实现（“com.fasterxml.jackson.module：jackson-module-kotlin”） } ## 实体模式数据类环境（有效 ID：UUID，值名称：字符串， val status：环境状态， val 创建时间：即时， val updateAt：即时？）枚举类环境状态{ 待处理、正在运行、已停止、失败 } ## 服务模式 @服务类环境服务（私有 val 存储库：EnvironmentRepository，私有valcomputeClient：ComputeClient ）{ // 使用 NEVER 传播 - 让调用者控制事务 @Transactional(传播=传播.NEVER) 有趣的创建（请求：CreateEnvironmentRequest）：Pair { // 检查是否存在（幂等性） repository.findByName(request.name)?.let { return Pair(it.toResponse(), false) // 现有 } // 创建新的 val 环境 = 环境( id = UUID.randomUUID(), 名称 = 请求名称，状态 = 环境状态.PENDING, 创建时间 = Instant.now(), 更新时间 = null ） val 保存=repository.save(环境) return Pair(saved.toResponse(), true) // 创建 } fun findById(id: UUID): 环境 = 存储库.findById(id) ?: 抛出 ResourceNotFoundRestException("环境", id) fun findAll(): List<环境> = 存储库.findAll() } ## 控制器模式 @RestController 类环境控制器（私人价值服务：EnvironmentService ) : 环境 API { 覆盖乐趣创建（请求：CreateEnvironmentRequest）：ResponseEntity { val (结果, isNew) = service.create(请求) 返回 if (isNew) { ResponseEntity.status(HttpStatus.CREATED).body(结果) } 否则{ ResponseEntity.ok（结果） } } 覆盖 fun getById(id: UUID): ResponseEntity = ResponseEntity.ok(service.findById(id).toResponse()) 覆盖 fun list(): ResponseEntity> = ResponseEntity.ok(service.findAll().map { it.toResponse() }) } ## API 接口模式（OpenAPI） @Tag(name = "环境",description = "环境管理") 接口环境Api { @Operation(summary = "创建环境") @ApiResponses( ApiResponse(responseCode = "201", 描述 = "已创建"), ApiResponse(responseCode = "200", 描述 = "已存在"), ApiResponse(responseCode = "400", 描述 = "验证错误") ） @PostMapping(“/api/v1/环境”) 有趣的创造（ @RequestBody @Valid请求：CreateEnvironmentRequest ): ResponseEntity<环境响应> @Operation(summary = "通过ID获取环境") @GetMapping(“/api/v1/environments/{id}”) fun getById(@PathVariable id: UUID): ResponseEntity @Operation(summary = "列出所有环境") @GetMapping(“/api/v1/环境”) fun list(): ResponseEntity> } ## DTO 模式数据类 CreateEnvironmentRequest( @field:NotBlank(message = "姓名为必填项") @field:Size(max = 100, message = "名称必须 <= 100 个字符") 值名称：字符串， @字段：大小（最大= 500） val 描述：字符串？ = 空）数据类环境响应（有效 ID：UUID，值名称：字符串， val状态：字符串， val 创建时间：即时） // 映射扩展函数有趣的环境.toResponse() = 环境响应( id = id, 姓名=姓名，状态 = 状态.名称, 创建时间 = 创建时间） ## 异常处理 // 类型异常抛出 ResourceNotFoundRestException("环境", id) throw ValidationRestException("名称不能为空") throw ConflictRestException("环境已存在") // 全局处理程序 @RestControllerAdvice 类 GlobalExceptionHandler { @ExceptionHandler(ResourceNotFoundRestException::class) 有趣的handleNotFound（例如：ResourceNotFoundRestException）：ResponseEntity = ResponseEntity.status(HttpStatus.NOT_FOUND) .body(ErrorResponse(例如.message ?: "未找到")) @ExceptionHandler(MethodArgumentNotValidException::class) 有趣的handleValidation（例如：MethodArgumentNotValidException）：ResponseEntity { val 错误 = ex.bindingResult.fieldErrors.map { "${it.field}: ${it.defaultMessage}" } 返回 ResponseEntity.badRequest() .body(ErrorResponse("验证失败", 错误)) } } ## Kotlin 习语 // 使用 ?.let 进行可选操作 user?.let {repository.save(it) } // 使用when进行穷举匹配当（状态）{ 环境状态.PENDING -> startEnvironment() EnvironmentStatus.RUNNING -> return // 已经在运行 EnvironmentStatus.STOPPED -> restartEnvironment() EnvironmentStatus.FAILED -> 抛出 IllegalStateException(“无法启动失败的环境”) } // 避免！ - 使用替代品 repository.findById(id).single() // 如果不完全是一个则抛出异常 repository.findById(id).firstOrNull() // 如果没有则返回 null // 用于不可变更新的数据类副本 val 更新 = 环境.copy( 状态 = 环境状态.RUNNING, updateAt = Instant.now() ） ## 配置属性 @ConfigurationProperties（前缀=“逆戟鲸”）数据类 OrcaProperties( val 计算：ComputeProperties， val 超时：TimeoutProperties ）{ 数据类ComputeProperties( val url：字符串， val 超时：持续时间 = Duration.ofSeconds(30) ）数据类超时属性（ val 创建：Duration = Duration.ofMinutes(5), val 终止：Duration = Duration.ofMinutes(2) ） }

Kotlin Spring Boot

包含技能