Data structures 作为API蓝图数据结构的基元类型
我想使用原语类型来描述数据结构。像这样:Data structures 作为API蓝图数据结构的基元类型,data-structures,apiblueprint,aglio,mson,Data Structures,Apiblueprint,Aglio,Mson,我想使用原语类型来描述数据结构。像这样: # Data Structures ## Video Delete (enum[number]) + `0` - Successful deletion. + `1` - Error occured. 输出为 { "enum": [ 1, 0 ], "$schema": "http://json-schema.org/draft-04/schema#" } 所以描述不见了。我试着把描述放在不同
# Data Structures
## Video Delete (enum[number])
+ `0` - Successful deletion.
+ `1` - Error occured.
输出为
{
"enum": [
1,
0
],
"$schema": "http://json-schema.org/draft-04/schema#"
}
所以描述不见了。我试着把描述放在不同的地方。我做了很多事情(不想谈论它们)。我还尝试向枚举值添加信息,如下所示:
+ `0` (number) - Successful deletion.
我不知道这个问题是与MSON语法有关还是与Aglio生成器有关。据我所知,MSON支持上述语法。问题是Aglio没有对这个描述做任何事情,当我开始考虑添加它时,我意识到在JSON模式中并不真正支持它。人们似乎用两种方法来回避这个事实: <> >将枚举值描述添加到主描述中,OLIO主题1.62支持此,但是C++分析器在这个特性方面仍然存在一些缺陷:
##视频删除(枚举[编号])-0表示成功,1表示错误
oneOf
语法,在该语法中可以创建带有描述的单个枚举集。我不推荐这个