2

我想将自定义对象定义为 json 模式文件,并将相关示例定义为单独的文件。我想做这样的事情:

#%RAML 1.0
title: MDM
version: v1
baseUri: http://api.mdm.ishafoundation.org
mediaType: application/json
types:
  Contact:
    type: !include schemas/contact.json
    example: !include examples/contact.example.json

但是对于以“type:”语句开头的行,我收到以下错误消息-“错误:您不能从两种不同类型的类型中继承”

在规范中它说

外部类型不能参与类型继承或特化。换句话说:您不能定义声明新属性或设置构面的外部类型的子类型。但是,您可以创建简单的类型包装器来添加元数据、示例和描述。

我猜这就是问题所在。但我不知道创建“类型包装器”意味着什么。有人可以告诉我实现我想要的最佳方法是什么。

4

1 回答 1

1

RAML 规范显示了一个与您在此处发布的完全一样的示例,因此它应该可以工作,否则规范中有错误。

无论如何,这种编写 RAML 的方式是有效的:

#%RAML 1.0
title: MDM
version: v1
baseUri: http://api.mdm.ishafoundation.org
mediaType: application/json
types:
 Contact: !include schemas/contact.json

不确定如何在此处放置示例,但您始终可以将其直接添加到方法中。

于 2015-12-09T12:14:02.443 回答