java - 将 2 个 Controller 方法映射到具有不同查询参数的同一端点

Question

我想在 Java 中实现一个带有“重载”端点的 REST API，该端点因传递的查询参数而异。
我已经在我的 Controller 类中尝试过这段代码:

@Get("/query")
public MyResponse queryByDate(@QueryValue @Valid @Format("yyyy-MM-dd") Date date) {
    // Code to generate the response
    return retval;
}

@Get("/query")
public MyResponse queryByDateAndValue(@QueryValue @Valid @Format("yyyy-MM-dd") Date date, @QueryValue int value) {
    // Code to generate the response
    return retval;
}

这将返回以下错误:

More than 1 route matched the incoming request. The following routes matched /calendar/years/query: GET - /calendar/years/query, GET - /calendar/years/query
io.micronaut.web.router.exceptions.DuplicateRouteException: More than 1 route matched the incoming request. The following routes matched /calendar/years/query: GET - /calendar/years/query, GET - /calendar/years/query

请注意，如果我删除其中一个方法，其余方法将按预期工作。如何将具有不同查询参数的端点映射到 Controller 中的 2 个不同方法？这可能吗？

谢谢。

Answer 1

您收到错误，因为两个端点具有相同的路径，并且它会混淆编译器将 API 映射到相应的路径。传递查询参数并不意味着端点具有不同的路径。您可以将这两个端点合二为一:

@Get("/query")
public MyResponse queryByDateAndValue(@QueryValue @Valid @Format("yyyy-MM-dd") Date date,@DefaultValue("1")  @QueryValue int value) {
    // Code to generate the response
    return retval;
}

并设置value的默认值。然后您可以相应地分开您的案例。