API Blueprint文件中包含的含义是什么?

时间:2016-09-02 14:50:19

标签: apiblueprint

我无法在API蓝图规范中看到它的任何提及,尽管有一个功能请求要添加包含其他文件的include指令。

1 个答案:

答案 0 :(得分:3)

不要将

Include与包含其他文件的同名非标准指令相混淆(尽管API Blueprint的aglio工具确实支持后者)。

Includethe MSON specification中定义,由API蓝图规范引用。例如,在API Blueprint文件的Data Structures部分中,使用MSON定义其中定义的命名类型。

Include与Java中的extends类似 - 它使当前正在定义的类型继承指定"超类型"的所有字段。关键字Include后面可能跟着一个命名类型的名称(通常的用法),或者有点奇怪的是,它是一个内联类型定义:

  

MSON定义了一个支持多重继承的Mixin类型   另一个命名类型。要继承的命名类型必须是一个结构   输入或其子类型。

     

在混合名称中定义并继承的嵌套成员类型   类型是在Mixin类型的相同缩进级别添加的。

     

Mixin Type→ - 包含类型名称| - 包括类型定义