使用Kotlin/Quarkus编写REST资源时如何避免代码冗余？

Quarkus + Kotlin 避免REST资源代码冗余的可行方案 #

由于Quarkus的REST注解扫描机制限制，直接继承泛型父类的方式确实无法正常识别路径、请求方法等元信息，可通过以下几种方案替代：

1. 使用注解处理器生成REST资源代码 #

• 自定义一套CRUD通用注解（比如@GenerateCrudResource），标注在你的实体类或者Repository接口上
• 基于Kotlin KSP（Kotlin Symbol Processing）编写注解处理器，编译阶段自动生成对应业务的REST资源类，所有通用CRUD逻辑直接在生成的代码中自动填充，业务侧只需要扩展自定义接口即可
• 不需要修改运行时逻辑，完全符合Quarkus的静态编译要求，性能不受任何影响

2. 使用REST Data Panache扩展 #

• Quarkus官方提供的REST Data扩展直接支持为Panache实体/Repository自动生成REST接口，不需要手动编写资源类
• Kotlin环境下只需要引入io.quarkus:quarkus-rest-data-panache和io.quarkus:quarkus-resteasy-reactive-jackson依赖，然后定义接口继承PanacheEntityResource即可，示例代码如下：

// 定义用户实体
@Entity
class User : PanacheEntity() {
    lateinit var username: String
    var age: Int = 0
}

// 直接生成完整的CRUD REST接口，路径默认是/users，支持分页、排序、过滤
interface UserResource : PanacheEntityResource<User, Long>

• 支持自定义接口路径、权限控制、请求参数校验，不需要写任何重复的CRUD逻辑

3. 组合通用服务层而非继承资源层 #

• 将通用的CRUD逻辑封装在GenericService<T>泛型服务类中，每个业务资源类只需要注入对应业务的Service实现，然后写极其精简的接口入口即可，示例代码如下：

// 通用泛型服务
abstract class GenericService<T> {
    abstract fun getById(id: Long): T?
    abstract fun create(entity: T): T
    abstract fun update(id: Long, entity: T): T?
    abstract fun delete(id: Long): Boolean
}

// 业务资源类，只需要写注解和调用服务层即可
@Path("/users")
class UserResource(@Inject val userService: UserService) {
    @GET
    @Path("/{id}")
    fun getById(@PathParam id: Long) = userService.getById(id)
    
    @POST
    fun create(@Valid user: User) = userService.create(user)
    // 其他接口逻辑一致，仅需要替换路径和参数类型即可
}

• 这种方式灵活性最高，自定义接口的时候可以随时扩展特殊逻辑，代码重复量极低，完全适配Quarkus的注解扫描规则

4. 使用Kotlin扩展函数简化重复逻辑 #

• 把通用的请求参数解析、响应封装、异常处理逻辑封装成Kotlin扩展函数，在各个资源类中直接调用，可以进一步减少模板代码
• 比如封装分页参数解析、结果包装的扩展函数，不需要每个接口都重复写参数处理逻辑

内容的提问来源于stack exchange，提问作者rjjdv