RAML:向包含的json模式类型添加示例属性

RAML:向包含的json模式类型添加示例属性,json,raml,Json,Raml,我想将自定义对象定义为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.exampl

我想将自定义对象定义为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:”语句开始的行中得到以下错误消息-“error:您不能从两种不同类型的类型继承”

说明书上写着

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


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

RAML规范显示了一个与您在这里发布的内容完全相同的示例,因此它应该可以工作,或者规范中有错误

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

#%RAML 1.0
title: MDM
version: v1
baseUri: http://api.mdm.ishafoundation.org
mediaType: application/json
types:
 Contact: !include schemas/contact.json
不确定如何适合那里的示例,但您始终可以将其直接添加到方法中