java - Swagger UI 和 Play 路由 *path

Question

我在 Swagger 理解 Play 时遇到了困难! 2.0 路由通配符路由，因此 swagger ui 最终会出现损坏的 URL。 我的路线文件有这样的路线:

GET           /settings/api/:project/*path                       @controllers.API.getParams(project, path)

然后我的 Controller 有以下代码:

@ApiOperation(value = "Returns settings for given project and path.", response = String.class, httpMethod = "GET")
@ApiResponses(value = {
        @ApiResponse(code = 200, message = "Request completed successfully."),
        @ApiResponse(code = 500, message = "Internal error while processing request")
})
@ApiImplicitParams({
        @ApiImplicitParam(name = "project", value = "Project name", required = true, dataType = "String", paramType = "path"),
        @ApiImplicitParam(name = "path", value = "path", required = true, dataType = "String", paramType = "path")
})
public Result getParams(String project, String path) {
    return ok(path);
}

然后，当 Swagger UI 渲染时，我看到此操作的路径渲染为

POST /settings/api/{project}/{path<.+>

当我打电话时，它会变成

/settings/api/test/{path<.+>

所以基本上 :project 被替换，但 *path 仍然损坏/完整。 如果您知道如何解决此问题，请分享。谢谢!

Answer 1

事实证明 swagger 不支持通配符路由。