内联附加类型数据

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.