我无法在API蓝图规范中看到它的任何提及,尽管有一个功能请求要添加包含其他文件的include指令。
答案 0 :(得分:3)
Include
与包含其他文件的同名非标准指令相混淆(尽管API Blueprint的aglio
工具确实支持后者)。
Include
在the MSON specification中定义,由API蓝图规范引用。例如,在API Blueprint文件的Data Structures部分中,使用MSON定义其中定义的命名类型。
Include与Java中的extends
类似 - 它使当前正在定义的类型继承指定"超类型"的所有字段。关键字Include
后面可能跟着一个命名类型的名称(通常的用法),或者有点奇怪的是,它是一个内联类型定义:
MSON定义了一个支持多重继承的Mixin类型 另一个命名类型。要继承的命名类型必须是一个结构 输入或其子类型。
在混合名称中定义并继承的嵌套成员类型 类型是在Mixin类型的相同缩进级别添加的。
Mixin Type→ - 包含类型名称| - 包括类型定义