内联附加类型数据
Appending type data inline
在我的用例中,我有一个由我们的研发部门创建的 RAML 1.0 库,其中包含多种数据类型的定义。这些数据类型是以通用的、参数化的方式定义的,所以当我在我的 RAML 中引用它们时,我使用以下语法这样做:
type: { resourceTypes.collectionWithCriteria: {itemName: reward, itemCriteria: types.RewardCriteria, itemType : types.RewardList} }
这会生成正确的 GET 请求,其中查询字符串由 types.RewardCriteria
定义,响应由 types.RewardList
定义。它还为定义为 Retrieves the list of <<itemName | !pluralize>>
的 GET 资源生成描述,最终为 Retrieves the list of rewards
.
在我的 RAML 中,我想将附加描述附加到我的 GET 资源中,但是我宁愿避免覆盖库生成的描述。那可能吗?我已经尝试过内联描述和使用覆盖文件,这两者都只是从库中替换描述。
您不能追加单个值简单 属性。
merging rules for traits / resource types说明将被替换的说明:
Every explicit node wins over the ones that are declared in a resource
type or trait. The rest are simply merged.
此外,merging rules of overlays and extensions 指出:.
If the property is a Simple Property
If the property is a Single-value Simple Property,
The property value in the identically named Current Target Tree Object property is replaced with its value from Current Extension Tree Object property.
在我的用例中,我有一个由我们的研发部门创建的 RAML 1.0 库,其中包含多种数据类型的定义。这些数据类型是以通用的、参数化的方式定义的,所以当我在我的 RAML 中引用它们时,我使用以下语法这样做:
type: { resourceTypes.collectionWithCriteria: {itemName: reward, itemCriteria: types.RewardCriteria, itemType : types.RewardList} }
这会生成正确的 GET 请求,其中查询字符串由 types.RewardCriteria
定义,响应由 types.RewardList
定义。它还为定义为 Retrieves the list of <<itemName | !pluralize>>
的 GET 资源生成描述,最终为 Retrieves the list of rewards
.
在我的 RAML 中,我想将附加描述附加到我的 GET 资源中,但是我宁愿避免覆盖库生成的描述。那可能吗?我已经尝试过内联描述和使用覆盖文件,这两者都只是从库中替换描述。
您不能追加单个值简单 属性。
merging rules for traits / resource types说明将被替换的说明:
Every explicit node wins over the ones that are declared in a resource type or trait. The rest are simply merged.
此外,merging rules of overlays and extensions 指出:.
If the property is a Simple Property
If the property is a Single-value Simple Property, The property value in the identically named Current Target Tree Object property is replaced with its value from Current Extension Tree Object property.