在 Quarkus Microprofile 中验证 REST 参数答案

【问题标题】：Validate REST parameter in Quarkus Microprofile在 Quarkus Microprofile 中验证 REST 参数
【发布时间】：2021-04-06 14:41:43
【问题描述】：

以下代码是 Quarkus Microprofile API 应用程序中控制器的一部分。

    @GET
    @Path("/limit/{limit}/offset/{offset}")
    @Produces(MediaType.APPLICATION_JSON)
    public Response paginatedAccounts(
            @Parameter(
                description = "Number of records to be returned.",
                required = true,
                schema = @Schema(type = SchemaType.INTEGER))
            @PathParam("limit") int limit,
            @Parameter(
                 description = "The starting number of record, zero based.",
                 required = true,
                 schema = @Schema(type = SchemaType.INTEGER))
             @PathParam("offset") int offset)
    {
        return Response
                .ok(this.accountService.getPaginatedAccounts(limit, offset))
                .build();
    }

它返回一个分页的帐户列表。

当用户调用提供错误类型“limit”或“offset”的API时，即：

http://[url]/[entity]/limit/zzz/offset/0

她收到 “404 - 未找到”

如何验证参数“limit”和“offset”，以便当用户提供错误类型（int 的字符串）时，她会收到：

“400 - 错误请求”

应该是这样吗？

【问题讨论】：

标签： api rest quarkus microprofile

【解决方案1】：

这是设计使然（根据 JAX-RS 规范）。

https://docs.oracle.com/cd/E19798-01/821-1841/6nmq2cp1v/index.html 明确提及：

如果 URI 路径模板变量无法转换为指定类型，则 JAX-RS 运行时会向客户端返回 HTTP 400（“错误请求”）错误。如果无法将 @PathParam 注释转换为指定类型，则 JAX-RS 运行时会向客户端返回 HTTP 404（“未找到”）错误

【讨论】：

在我的示例中，“URI 路径模板变量”到底是什么？我知道“限制”是@PathParam，但我不明白在什么情况下 JAX-RS 会返回 HTTP 400。