Quarkus的Response类型无法接收泛型参数，如何实现类似Spring ResponseEntity的效果？

Quarkus 提供了RestResponse<T> 类，完全对标Spring的ResponseEntity<T>能力，支持绑定实际返回类型参数。

用法示例 #

接口定义 #

把原有无类型的Response接口定义：

Response findAll();

直接替换为带泛型的写法即可：

RestResponse<List<SampleResponse>> findAll();

返回值构造 #

构造方式和原有Response几乎完全兼容，同时支持泛型类型传递：

// 成功返回带业务数据的响应
return RestResponse.ok(sampleResponseList);

// 自定义状态码、响应头的场景
return RestResponse.status(201)
        .header("X-Resource-Id", newResourceId)
        .entity(new SampleResponse(id, name))
        .build();

核心优势 #

• 泛型信息会被Quarkus自带的OpenAPI/Swagger扩展自动识别，生成接口文档时无需额外注解声明返回结构，自动带出SampleResponse的字段定义
• 序列化阶段会基于泛型类型做更精准的类型处理，避免类型擦除带来的序列化问题
• 完全兼容JAX-RS Response的所有能力，包括状态码设置、响应头添加、cookie设置等操作

注意事项 #

RestResponse<T>是Quarkus REST（默认使用的RESTEasy Reactive栈）内置的扩展类，无需引入额外依赖即可直接使用。如果仍在使用旧版RESTEasy Classic栈，升级到RESTEasy Reactive即可获得该能力。

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