swagger - Smallrye / Quarkus openapi 微配置文件会修剪包含点“。”的@ExampleObject#value。
问题描述
我正在使用 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 转义值,但这似乎也不起作用。这是一个查询参数。所以无论如何都不需要转义。
解决方案
推荐阅读
- neo4j - 如何获取子图中不相交的集群的计数
- python - 枕头(PIL Fork):使用带有自定义字体的 ImageFont/ImageDraw 方法时出错
- python - Django 本地主机连接中止
- ios - CoreData 使用 NSBatchInsertRequest
- php - 为什么这个联系表在我测试时会出错?
- plugins - 请告诉我如何编写 nuxt 插件 'printd'
- javascript - 如何在 ReactJS 中使用第三方脚本渲染 iframe
- python - 超参数调优
- cpu-registers - 从 GNU/Linux shell 使用 devmem 读取 Armv8-A 寄存器
- vue.js - 如何根据 url 将 Vuetify 选项卡设置为活动状态