swagger - Smallrye / Quarkus openapi 微配置文件会修剪包含点“。”的@ExampleObject#value。

Question

我正在使用 Quarkus (2.2) 及其 Smallrye 实现来生成一个招摇的文档页面。

这是一个操作示例：

   @GET
    @Path( "/codes" )
    @Produces( MediaType.APPLICATION_JSON )
    @Operation(
        operationId = "codes",
        summary = ""
    )
    @Parameter(
        name = "domain",
      :
        } )
    @Parameter(
        name = "version",
        content = @Content( mediaType = MediaType.TEXT_PLAIN ),
        description = "a description",
        examples = {
            @ExampleObject(
                name = "a version",
                description = "specific version: <major>.<minor>",
                value = "1.0" )
    )

    Codes getCodes(@QueryParam( "domain" ) String domain, @QueryParam( "version" ) String version);

我在伪代码中缩写了原始示例 (:)

但是，当我在服务中收到版本参数时，点和点 '.' 后面的所有内容都会被修剪。所以在示例中它只是设置为'1'

进一步：“01.1”有效，“1.11”有效。但是“2.0”没有。

这里有什么问题？我使用 URL 转义值，但这似乎也不起作用。这是一个查询参数。所以无论如何都不需要转义。